Fix(guide): Add details on how Gatsby works

This commit is contained in:
Raja Mehmood Ul Hassan
2018-10-23 22:43:43 +05:00
committed by Heather Kusmierz
parent 37da128eab
commit e1d98e3402

View File

@@ -8,8 +8,23 @@ Gatsby is a static site generator for [React](https://guide.freecodecamp.org/rea
The Gatsby environment provides several "starters" to help configure static sites quickly. Starters can be found here: [Starter Library](https://www.gatsbyjs.org/starters/). The Gatsby environment provides several "starters" to help configure static sites quickly. Starters can be found here: [Starter Library](https://www.gatsbyjs.org/starters/).
### Installation and using the Gatsby CLI ### How Gatsby works
Gatsby builds sites with the data provided by developer, regardless of the source.
#### Data sources
Gatsby accepts the data behind the site in various formats, such as:
1- CMSs: Wordpress, Contenful, Drupal, etc.
2- Markdown: Documentation, posts, etc.
3- Data: APIs, Databasses, JSON, CSV, etc.
#### Build
Gatsby's build is powered by GraphQL and rendered through HTML, CSS, and React.
#### Deploy
Gatsby deploys the site on a static web host such as Amazon S3, Netlify, Github Pages, Surge.sh and many more.
### Installation and using the Gatsby CLI
* Node: `npm install --global gatsby-cli` * Node: `npm install --global gatsby-cli`
* Get started with the official Gatsby starter: `gatsby new gatsby-site https://github.com/gatsbyjs/gatsby-starter-default` * Get started with the official Gatsby starter: `gatsby new gatsby-site https://github.com/gatsbyjs/gatsby-starter-default`
* After that change to the newly created directory `cd gatsby-site` * After that change to the newly created directory `cd gatsby-site`
@@ -17,5 +32,5 @@ The Gatsby environment provides several "starters" to help configure static site
* To generate the static HTML pages use `gatsby build` * To generate the static HTML pages use `gatsby build`
* `gatsby serve` will start a local server that will present your built site. * `gatsby serve` will start a local server that will present your built site.
#### More Information: ### More Information:
For tutorials and more information check out the Gatsby.js official site: [Gatsby.js official site](https://www.gatsbyjs.org/tutorial/) For tutorials and more information check out the Gatsby.js official site: [Gatsby.js official site](https://www.gatsbyjs.org/tutorial/)