-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: Update README.md and gatsby-config.js
- Loading branch information
1 parent
537a759
commit 78076c6
Showing
3 changed files
with
20 additions
and
111 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,19 +1,7 @@ | ||
<!-- Thanks for submitting a pull request! Please provide enough information so that others can review your pull request. --> | ||
<!-- Explain the **motivation** for making this change. What existing problem does the pull request solve? --> | ||
<!-- Try to link to an open issue for more information. --> | ||
**Issue being addressed:** | ||
|
||
|
||
<!-- In addition to that please answer these questions: --> | ||
**How does this PR address it?** | ||
|
||
**What kind of change does this PR introduce?** | ||
|
||
<!-- E.g. a bugfix, feature, refactoring, build related change, etc… --> | ||
|
||
**Does this PR introduce a breaking change?** | ||
|
||
<!-- If this PR introduces a breaking change, please describe the impact and a migration path for existing applications. --> | ||
|
||
**What needs to be documented once your changes are merged?** | ||
|
||
<!-- List all the information that needs to be added to the documentation after merge --> | ||
<!-- When your changes are merged you will be asked to contribute this to the documentation --> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,123 +1,44 @@ | ||
# Gatsby + Netlify CMS Starter | ||
# Pursuit of Innovation: Pi515 | ||
|
||
[](https://app.netlify.com/sites/gatsby-starter-netlify-cms-ci/deploys) | ||
|
||
**Note:** This starter uses [Gatsby v2](https://www.gatsbyjs.org/blog/2018-09-17-gatsby-v2/). | ||
|
||
This repo contains an example business website that is built with [Gatsby](https://www.gatsbyjs.org/), and [Netlify CMS](https://www.netlifycms.org): **[Demo Link](https://gatsby-netlify-cms.netlify.com/)**. | ||
'This repo is the main webpage for Pi515. It is built with [Gatsby](https://www.gatsbyjs.org/), and [Netlify CMS](https://www.netlifycms.org) | ||
|
||
It follows the [JAMstack architecture](https://jamstack.org) by using Git as a single source of truth, and [Netlify](https://www.netlify.com) for continuous deployment, and CDN distribution. | ||
|
||
## Features | ||
|
||
- A simple landing page with blog functionality built with Netlify CMS | ||
- Editabe Pages: Landing, About, Product, Blog-Collection and Contact page with Netlify Form support | ||
- Create Blog posts from Netlify CMS | ||
- Tags: Separate page for posts under each tag | ||
- Basic directory organization | ||
- Uses Bulma for styling, but size is reduced by `purge-css-plugin` | ||
- Blazing fast loading times thanks to pre-rendered HTML and automatic chunk loading of JS files | ||
- Uses `gatsby-image` with Netlify-CMS preview support | ||
- Separate components for everything | ||
- Netlify deploy configuration | ||
- Perfect score on Lighthouse for SEO, Accessibility and Performance (wip:PWA) | ||
- ..and more | ||
## Tech Stack 🥞 | ||
- Website: [Gatsby](https://www.gatsbyjs.org/) + [React](https://reactjs.org/) | ||
- Styling: [Bulma](https://bulma.io/) | ||
- CMS: [Netlify CMS](https://www.netlifycms.org) | ||
- Build: [Netlify](http://netlify.com/) | ||
|
||
## Prerequisites | ||
## Development | ||
### Prerequisites | ||
|
||
- Node (I recommend using v8.2.0 or higher) | ||
- [Gatsby CLI](https://www.gatsbyjs.org/docs/) | ||
- [Netlify CLI](https://github.com/netlify/cli) | ||
|
||
## Getting Started (Recommended) | ||
### Running Locally | ||
|
||
Netlify CMS can run in any frontend web environment, but the quickest way to try it out is by running it on a pre-configured starter site with Netlify. The example here is the Kaldi coffee company template (adapted from [One Click Hugo CMS](https://github.com/netlify-templates/one-click-hugo-cms)). Use the button below to build and deploy your own copy of the repository: | ||
|
||
<a href="https://app.netlify.com/start/deploy?repository=https://github.com/netlify-templates/gatsby-starter-netlify-cms&stack=cms"><img src="https://www.netlify.com/img/deploy/button.svg" alt="Deploy to Netlify"></a> | ||
|
||
After clicking that button, you’ll authenticate with GitHub and choose a repository name. Netlify will then automatically create a repository in your GitHub account with a copy of the files from the template. Next, it will build and deploy the new site on Netlify, bringing you to the site dashboard when the build is complete. Next, you’ll need to set up Netlify’s Identity service to authorize users to log in to the CMS. | ||
|
||
### Access Locally | ||
|
||
Pulldown a local copy of the Github repository Netlify created for you, with the name you specified in the previous step | ||
Clone this repository and do the following | ||
``` | ||
$ git clone https://github.com/[GITHUB_USERNAME]/[REPO_NAME].git | ||
$ cd [REPO_NAME] | ||
$ yarn | ||
$ netlify dev # or ntl dev | ||
npm install | ||
gatsby develop | ||
``` | ||
|
||
This will create a local version of website that hot-reloads to show changes as you make them | ||
|
||
### Testing CMS locally | ||
To test the CMS locally, you'll need to run a production build of the site: | ||
|
||
``` | ||
$ npm run build | ||
$ netlify dev # or ntl dev | ||
``` | ||
|
||
### Media Libraries (installed, but optional) | ||
|
||
Media Libraries have been included in this starter as a default. If you are not planning to use `Uploadcare` or `Cloudinary` in your project, you **can** remove them from module import and registration in `src/cms/cms.js`. Here is an example of the lines to comment or remove them your project. | ||
|
||
```javascript | ||
import CMS from 'netlify-cms-app' | ||
// import uploadcare from 'netlify-cms-media-library-uploadcare' | ||
// import cloudinary from 'netlify-cms-media-library-cloudinary' | ||
|
||
import AboutPagePreview from './preview-templates/AboutPagePreview' | ||
import BlogPostPreview from './preview-templates/BlogPostPreview' | ||
import ProductPagePreview from './preview-templates/ProductPagePreview' | ||
import IndexPagePreview from './preview-templates/IndexPagePreview' | ||
|
||
// CMS.registerMediaLibrary(uploadcare); | ||
// CMS.registerMediaLibrary(cloudinary); | ||
|
||
CMS.registerPreviewTemplate('index', IndexPagePreview) | ||
CMS.registerPreviewTemplate('about', AboutPagePreview) | ||
CMS.registerPreviewTemplate('products', ProductPagePreview) | ||
CMS.registerPreviewTemplate('blog', BlogPostPreview) | ||
``` | ||
|
||
Note: Don't forget to also remove them from `package.json` and `yarn.lock` / `package-lock.json` using `yarn` or `npm`. During the build netlify-cms-app will bundle the media libraries as well, having them removed will save you build time. | ||
Example: | ||
``` | ||
yarn remove netlify-cms-media-library-uploadcare | ||
``` | ||
OR | ||
``` | ||
yarn remove netlify-cms-media-library-cloudinary | ||
``` | ||
## Getting Started (Without Netlify) | ||
|
||
``` | ||
$ gatsby new [SITE_DIRECTORY_NAME] https://github.com/netlify-templates/gatsby-starter-netlify-cms/ | ||
$ cd [SITE_DIRECTORY_NAME] | ||
$ npm run build | ||
$ npm run serve | ||
``` | ||
|
||
### Setting up the CMS | ||
|
||
Follow the [Netlify CMS Quick Start Guide](https://www.netlifycms.org/docs/quick-start/#authentication) to set up authentication, and hosting. | ||
|
||
## Debugging | ||
|
||
Windows users might encounter `node-gyp` errors when trying to npm install. | ||
To resolve, make sure that you have both Python 2.7 and the Visual C++ build environment installed. | ||
|
||
``` | ||
npm config set python python2.7 | ||
npm install --global --production windows-build-tools | ||
``` | ||
|
||
[Full details here](https://www.npmjs.com/package/node-gyp 'NPM node-gyp page') | ||
|
||
MacOS users might also encounter some errors, for more info check [node-gyp](https://github.com/nodejs/node-gyp). We recommend using the latest stable node version. | ||
|
||
## Purgecss | ||
|
||
This plugin uses [gatsby-plugin-purgecss](https://www.gatsbyjs.org/packages/gatsby-plugin-purgecss/) and [bulma](https://bulma.io/). The bulma builds are usually ~170K but reduced 90% by purgecss. | ||
|
||
# CONTRIBUTING | ||
|
||
Contributions are always welcome, no matter how large or small. Before contributing, | ||
please read the [code of conduct](CODE_OF_CONDUCT.md). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters