Update links, clean up quotes

This commit is contained in:
Daniel Lautzenheiser 2022-10-25 11:55:37 -04:00
parent 751c38a034
commit c7f1433002
17 changed files with 29 additions and 31 deletions

View File

@ -95,7 +95,7 @@ backend:
When debugging the CMS with Git Gateway you must: When debugging the CMS with Git Gateway you must:
1. Have a Netlify site with [Git Gateway](https://docs.netlify.com/visitor-access/git-gateway/) and [Netlify Identity](https://docs.netlify.com/visitor-access/identity/) enabled. An easy way to create such a site is to use a [template](https://staticjscms.github.io/static-cms/docs/start-with-a-template/), for example the [Gatsby template](https://app.netlify.com/start/deploy?repository=https://github.com/AustinGreen/gatsby-starter-netlify-cms&stack=cms) 1. Have a Netlify site with [Git Gateway](https://docs.netlify.com/visitor-access/git-gateway/) and [Netlify Identity](https://docs.netlify.com/visitor-access/identity/) enabled. An easy way to create such a site is to use a [template](https://staticjscms.netlify.app/docs/start-with-a-template/), for example the [Gatsby template](https://app.netlify.com/start/deploy?repository=https://github.com/AustinGreen/gatsby-starter-netlify-cms&stack=cms)
2. Tell the CMS the URL of your Netlify site using a local storage item. To do so: 2. Tell the CMS the URL of your Netlify site using a local storage item. To do so:
1. Open `http://localhost:8080/` in the browser 1. Open `http://localhost:8080/` in the browser

View File

@ -8,7 +8,7 @@
</div> </div>
[staticjscms.github.io/static-cms](https://staticjscms.github.io/static-cms/) [staticjscms.netlify.app](https://staticjscms.netlify.app/)
A CMS for static site generators. Give users a simple way to edit A CMS for static site generators. Give users a simple way to edit
and add content to any site built with a static site generator. and add content to any site built with a static site generator.
@ -31,16 +31,16 @@ tweak the main layout of the CMS a bit to fit your own site.
When a user navigates to `/admin/` they'll be prompted to log in, and once authenticated When a user navigates to `/admin/` they'll be prompted to log in, and once authenticated
they'll be able to create new content or edit existing content. they'll be able to create new content or edit existing content.
Read more about Static CMS [Core Concepts](https://staticjscms.github.io/static-cms/docs/intro/). Read more about Static CMS [Core Concepts](https://staticjscms.netlify.app/docs/intro/).
# Installation and Configuration # Installation and Configuration
The Static CMS can be used in two different ways. The Static CMS can be used in two different ways.
* A Quick and easy install, that requires you to create a single HTML file and a configuration file. All the CMS JavaScript and CSS are loaded from a CDN. * A Quick and easy install, that requires you to create a single HTML file and a configuration file. All the CMS JavaScript and CSS are loaded from a CDN.
To learn more about this installation method, refer to the [CDN Hosting Guide](https://staticjscms.github.io/static-cms/docs/add-to-your-site-cdn/) To learn more about this installation method, refer to the [CDN Hosting Guide](https://staticjscms.netlify.app/docs/add-to-your-site-cdn/)
* A complete, more complex install, that gives you more flexibility but requires that you use a static site builder with a build system that supports npm packages. * A complete, more complex install, that gives you more flexibility but requires that you use a static site builder with a build system that supports npm packages.
To learn more about this installation method, refer to the [Bundling Guide](https://staticjscms.github.io/static-cms/docs/add-to-your-site-bundling/) To learn more about this installation method, refer to the [Bundling Guide](https://staticjscms.netlify.app/docs/add-to-your-site-bundling/)
# Contributing # Contributing

File diff suppressed because one or more lines are too long

View File

@ -155,7 +155,7 @@ const Header = ({
)} )}
{isTestRepo && ( {isTestRepo && (
<Button <Button
href="https://staticjscms.github.io/static-cms/docs/test-backend" href="https://staticjscms.netlify.app/docs/test-backend"
target="_blank" target="_blank"
rel="noopener noreferrer" rel="noopener noreferrer"
sx={{ textTransform: 'none' }} sx={{ textTransform: 'none' }}

View File

@ -29,7 +29,7 @@ If you are able to offer up a change to existing content, we welcome this. Once
While we work on building this page (and you can help!), here are some links with more information about getting involved: While we work on building this page (and you can help!), here are some links with more information about getting involved:
* [Setup instructions and Contribution Guidelines](https://github.com/StaticJsCMS/static-cms/blob/master/CONTRIBUTING.md) * [Setup instructions and Contribution Guidelines](https://github.com/StaticJsCMS/static-cms/blob/master/CONTRIBUTING.md)
* [Join our Community Chat](https://staticjscms.github.io/static-cms/chat) * [Join our Community Chat](/chat)
* [Code of Conduct](https://github.com/StaticJsCMS/static-cms/blob/master/CODE_OF_CONDUCT.md) * [Code of Conduct](https://github.com/StaticJsCMS/static-cms/blob/master/CODE_OF_CONDUCT.md)
* [Project Milestones](https://github.com/StaticJsCMS/static-cms/milestones) * [Project Milestones](https://github.com/StaticJsCMS/static-cms/milestones)
* [Good First Issues](https://github.com/StaticJsCMS/static-cms/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22good+first+issue%22+-label%3Aclaimed) * [Good First Issues](https://github.com/StaticJsCMS/static-cms/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22good+first+issue%22+-label%3Aclaimed)

View File

@ -12,7 +12,7 @@ The Static CMS exposes a `window.CMS` a global object that you can use to regist
The `registerWidget` requires you to provide a React component. If you have a build process in place for your project, it is possible to integrate with this build process. The `registerWidget` requires you to provide a React component. If you have a build process in place for your project, it is possible to integrate with this build process.
However, although possible, it may be cumbersome or even impractical to add a React build phase. For this reason, Static CMS exposes two constructs globally to allow you to create components inline: createClass and h (alias for React.createElement). However, although possible, it may be cumbersome or even impractical to add a React build phase. For this reason, Static CMS exposes two constructs globally to allow you to create components inline: `createClass` and `h` (alias for React.createElement).
## `registerWidget` ## `registerWidget`

View File

@ -10,7 +10,7 @@ The Static CMS exposes a `window.CMS` global object that you can use to register
### React Components inline interaction ### React Components inline interaction
Static CMS is a collection of React components and exposes two constructs globally to allow you to create components inline: createClass and h (alias for React.createElement). Static CMS is a collection of React components and exposes two constructs globally to allow you to create components inline: `createClass` and `h` (alias for React.createElement).
## `registerPreviewTemplate` ## `registerPreviewTemplate`

View File

@ -29,7 +29,7 @@ The development server now serves your website at `http://localhost:3000`. As yo
## Push your project to GitHub ## Push your project to GitHub
Static CMS requires a [backend](https://staticjscms.github.io/static-cms/docs/backends-overview/) to store content. Static CMS supports using Git hosts, like GitHub or GitLab, as backends. This guide uses GitHub. Static CMS requires a [backend](/docs/backends-overview/) to store content. Static CMS supports using Git hosts, like GitHub or GitLab, as backends. This guide uses GitHub.
```bash ```bash
# 1. Initialize your local Git repository. # 1. Initialize your local Git repository.
@ -169,7 +169,7 @@ Your website is now deployed. Netlify provides you with a randomly generated dom
- { title: imageUrl, label: ImageURL, widget: string } - { title: imageUrl, label: ImageURL, widget: string }
``` ```
`config.yml` specifies what kind of content your blog posts have. The content specification enables Static CMS to edit existing posts and create new ones with the same format. To learn more, read about Static CMS' [](https://staticjscms.github.io/static-cms/docs/configuration-options/)[Configuration options](https://staticjscms.github.io/static-cms/docs/configuration-options/). `config.yml` specifies what kind of content your blog posts have. The content specification enables Static CMS to edit existing posts and create new ones with the same format. To learn more, read about Static CMS' [](/docs/configuration-options/)[Configuration options](/docs/configuration-options/).
5. Visit `localhost:3000/admin` 5. Visit `localhost:3000/admin`
You can now view and edit `2021-11-15-first-blog-post.md` through the admin interface. You can also create new blog posts. You can now view and edit `2021-11-15-first-blog-post.md` through the admin interface. You can also create new blog posts.
**Warning:** Any changes you publish through the admin interface will only effect your *remote GitHub repository*. To retrieve these changes locally, `git pull` from your local repository. **Warning:** Any changes you publish through the admin interface will only effect your *remote GitHub repository*. To retrieve these changes locally, `git pull` from your local repository.

View File

@ -5,7 +5,7 @@ weight: 10
--- ---
This guide will help you get started using Static CMS and Gatsby. This guide will help you get started using Static CMS and Gatsby.
To get up and running with Gatsby, youll need to have [Node.js](https://nodejs.org/) installed on your computer. *Note: Gatsby's minimum supported Node.js version is Node 8.* To get up and running with Gatsby, you'll need to have [Node.js](https://nodejs.org/) installed on your computer. *Note: Gatsby's minimum supported Node.js version is Node 8.*
## Create a new Gatsby site ## Create a new Gatsby site

View File

@ -204,7 +204,7 @@ You can see this basic template includes all the fields you've specified in your
Using `registerEditorComponent` we can register a block level component for the Markdown editor. You can use it to add Hugo's inbuilt shortcodes like `gist`,`youtube` and others as block components to the markdown editor. Using `registerEditorComponent` we can register a block level component for the Markdown editor. You can use it to add Hugo's inbuilt shortcodes like `gist`,`youtube` and others as block components to the markdown editor.
You can refer to [registering editor components](https://staticjscms.github.io/static-cms/docs/custom-widgets/#registereditorcomponent) for a getting started guide or for creating your own editor components. You can refer to [registering editor components](/docs/custom-widgets/#registereditorcomponent) for a getting started guide or for creating your own editor components.
**Example** **Example**

View File

@ -20,5 +20,5 @@ At its core, Static CMS is an open-source React app that acts as a wrapper for t
- Get a feel for the UI in the [demo site](https://cms-demo.netlify.com). (No login required. Click the login button to go straight to the CMS editor UI.) - Get a feel for the UI in the [demo site](https://cms-demo.netlify.com). (No login required. Click the login button to go straight to the CMS editor UI.)
- [Start with a template](/docs/start-with-a-template/) to make a Static CMS-enabled site of your own. - [Start with a template](/docs/start-with-a-template/) to make a Static CMS-enabled site of your own.
- Configure your existing site by following a [tutorial](/docs/add-to-your-site/) or checking [configuration options](/docs/configuration-options). - Configure your existing site by following a [tutorial](/docs/add-to-your-site/) or checking [configuration options](/docs/configuration-options).
- Ask questions and share ideas in the Static CMS [community chat](https://staticjscms.github.io/static-cms/chat). - Ask questions and share ideas in the Static CMS [community chat](/chat).
- Get involved in new developments and become a [contributor](/docs/contributor-guide/). - Get involved in new developments and become a [contributor](/docs/contributor-guide/).

View File

@ -15,7 +15,7 @@ If you're starting a new project, the fastest route to publishing on a Jekyll we
This guide will use the blog you get if you follow the [really excellent official Jekyll step by step tutorial](https://jekyllrb.com/docs/step-by-step/01-setup/) as a starting point. If you're new to Jekyll - I recommended you start by following the tutorial so you know your way around your new blog. Otherwise [you can clone this repo](https://github.com/adamwatters/jekyll-tutorial-with-netlify-cms/tree/without-cms) and checkout the `without-cms` branch. This guide will use the blog you get if you follow the [really excellent official Jekyll step by step tutorial](https://jekyllrb.com/docs/step-by-step/01-setup/) as a starting point. If you're new to Jekyll - I recommended you start by following the tutorial so you know your way around your new blog. Otherwise [you can clone this repo](https://github.com/adamwatters/jekyll-tutorial-with-netlify-cms/tree/without-cms) and checkout the `without-cms` branch.
![Jekyll tutorial blog screenshot](https://staticjscms.github.io/static-cms/img/screenshot-jekyll-tutorial-blog.png?raw=true) ![Jekyll tutorial blog screenshot](/img/screenshot-jekyll-tutorial-blog.png?raw=true)
## Add Static CMS ## Add Static CMS
@ -64,7 +64,7 @@ collections:
Static CMS stores content in your online Git repository. Therefore, to make content changes, users need to authenticate with the corresponding Git provider to prove that they have read and write access to that content. Static CMS stores content in your online Git repository. Therefore, to make content changes, users need to authenticate with the corresponding Git provider to prove that they have read and write access to that content.
Follow the directions in the Introduction section to [enable Netlify Identity and Git Gateway services](https://staticjscms.github.io/static-cms/docs/add-to-your-site/#enable-identity-and-git-gateway) for the backend, then [add the Identity widget](https://staticjscms.github.io/static-cms/docs/add-to-your-site/#add-the-netlify-identity-widget) to render a login portal on the frontend. Follow the directions in the Introduction section to [enable Netlify Identity and Git Gateway services](/docs/add-to-your-site/#enable-identity-and-git-gateway) for the backend, then [add the Identity widget](/docs/add-to-your-site/#add-the-netlify-identity-widget) to render a login portal on the frontend.
## CMS Configuration ## CMS Configuration
@ -190,7 +190,7 @@ Next, copy and paste the following into the collections array in `config.yml` be
- { label: 'Body', title: 'body', widget: 'markdown' } - { label: 'Body', title: 'body', widget: 'markdown' }
``` ```
Now that we have the `authors` collection configured, we can add an `author` field to the `blog` collection. We'll use the [relation widget](https://staticjscms.github.io/static-cms/docs/widgets/#relation) to define the relationship between blog posts and authors. Now that we have the `authors` collection configured, we can add an `author` field to the `blog` collection. We'll use the [relation widget](/docs/widgets/#relation) to define the relationship between blog posts and authors.
```yaml ```yaml
# updated fields in blog collection configuration # updated fields in blog collection configuration
@ -214,7 +214,7 @@ With that configuration added, you should be able to select the author for a pos
### About Page ### About Page
Our Jekyll blog includes an About page. It would nice to be able to edit that page just like we can edit our blog and author pages. Static CMS provides [file collections](https://staticjscms.github.io/static-cms/docs/collection-types/#file-collections) to solve this problem. Our Jekyll blog includes an About page. It would nice to be able to edit that page just like we can edit our blog and author pages. Static CMS provides [file collections](/docs/collection-types/#file-collections) to solve this problem.
Copy and paste the following into the collections array in `config.yml` Copy and paste the following into the collections array in `config.yml`

View File

@ -142,7 +142,7 @@ touch index.html
touch config.yml touch config.yml
``` ```
Paste HTML for Static CMS into your `public/admin/index.html` file (check out the [Add Netlify To Your Site](https://staticjscms.github.io/static-cms/docs/add-to-your-site/) section for more information) Paste HTML for Static CMS into your `public/admin/index.html` file (check out the [Add Netlify To Your Site](/docs/add-to-your-site/) section for more information)
```html ```html
<!doctype html> <!doctype html>
@ -229,6 +229,6 @@ Netlify's Identity and Git Gateway services allow you to manage CMS admin users
Great job - you did it! Open your new page via the new Netlify URL, and navigate to `/admin`. If you did everything correct in the previous step, you should now be able to sign up for an account, and log in. Great job - you did it! Open your new page via the new Netlify URL, and navigate to `/admin`. If you did everything correct in the previous step, you should now be able to sign up for an account, and log in.
**Tip:** Signing up with an external provider is the easiest. If you want to sign up by email, you'll have to set up a redirect in your index.js page (which we won't be covering in this guide). For more information, have a look at the [Add To Your Site](https://staticjscms.github.io/static-cms/docs/add-to-your-site) section. **Tip:** Signing up with an external provider is the easiest. If you want to sign up by email, you'll have to set up a redirect in your index.js page (which we won't be covering in this guide). For more information, have a look at the [Add To Your Site](/docs/add-to-your-site) section.
Congratulations - you can finally manage your new list of cats! Congratulations - you can finally manage your new list of cats!

View File

@ -6,8 +6,6 @@ weight: 2
You can add Static CMS [to an existing site](/docs/add-to-your-site/), but the quickest way to get started is with a template. Found below, our featured templates deploy a bare-bones site and Static CMS to Netlify, giving you a fully working CMS-enabled site with just a few clicks. You can add Static CMS [to an existing site](/docs/add-to-your-site/), but the quickest way to get started is with a template. Found below, our featured templates deploy a bare-bones site and Static CMS to Netlify, giving you a fully working CMS-enabled site with just a few clicks.
{' '}
<div style={{ display: 'grid', gridTemplateColumns: 'repeat(3, minmax(0, 1fr))', gap: '24px' }}> <div style={{ display: 'grid', gridTemplateColumns: 'repeat(3, minmax(0, 1fr))', gap: '24px' }}>
<div <div
style={{ style={{
@ -231,13 +229,13 @@ After clicking one of those buttons, authenticate with GitHub or GitLab and choo
**Note for Bitbucket users:** Static CMS supports Bitbucket repositories, but Bitbucket's permissions won't work with the Deploy to Netlify buttons above. You can still set up a repository manually, or follow the [tutorial](/docs/add-to-your-site) for adding Static CMS to an existing site. **Note for Bitbucket users:** Static CMS supports Bitbucket repositories, but Bitbucket's permissions won't work with the Deploy to Netlify buttons above. You can still set up a repository manually, or follow the [tutorial](/docs/add-to-your-site) for adding Static CMS to an existing site.
## Access Static CMS on your new site ## Access Static CMS
1. The template deploy process sends you an invitation to your new site, sent from `no-reply@netlify.com`. 1. The template deploy process sends you an invitation to your new site, sent from `no-reply@netlify.com`.
![Sample email subject line: You've been invited to join radiologist-amanda-53841.netlify.com](https://staticjscms.github.io/static-cms/img/email-subject.png?raw=true) ![Sample email subject line: You've been invited to join radiologist-amanda-53841.netlify.com](/img/email-subject.png?raw=true)
2. Wait for the deployment to complete, then click the link to accept the invite. Your site will open with a prompt to create a password. 2. Wait for the deployment to complete, then click the link to accept the invite. Your site will open with a prompt to create a password.
!["Complete your signup" modal on the Kaldi coffee site](https://staticjscms.github.io/static-cms/img/create-password.png?raw=true) !["Complete your signup" modal on the Kaldi coffee site](/img/create-password.png?raw=true)
3. Enter a password, sign in, and youll go to the CMS. (For future visits, you can go straight to `<yoursiteaddress.com>/admin/`.) 3. Enter a password, sign in, and you'll go to the CMS. (For future visits, you can go straight to `<yoursiteaddress.com>/admin/`.)
Try adding and editing posts, or changing the content of the Products page. When you save, the changes are pushed immediately to your Git repository, triggering a build on Netlify, and updating the content on your site. Check out the configuration code by visiting your site repo. Try adding and editing posts, or changing the content of the Products page. When you save, the changes are pushed immediately to your Git repository, triggering a build on Netlify, and updating the content on your site. Check out the configuration code by visiting your site repo.
@ -245,4 +243,4 @@ Try adding and editing posts, or changing the content of the Products page. When
- To see how to integrate Static CMS into an existing project, go to [Add to your site](/docs/add-to-your-site/). - To see how to integrate Static CMS into an existing project, go to [Add to your site](/docs/add-to-your-site/).
- Check out other sites using Static CMS (or share your own!) on the [Examples](/docs/examples/) page. - Check out other sites using Static CMS (or share your own!) on the [Examples](/docs/examples/) page.
- If youd like to add more CMS editors or change how they log in to your site, read up on [Netlify Identity service](https://www.netlify.com/docs/identity). - If you'd like to add more CMS editors or change how they log in to your site, read up on [Netlify Identity service](https://www.netlify.com/docs/identity).

View File

@ -32,7 +32,7 @@ media_library:
Once you've finished updating your Static CMS configuration, the Uploadcare widget will appear when using the image or file widgets. Once you've finished updating your Static CMS configuration, the Uploadcare widget will appear when using the image or file widgets.
**Note:** You'll need to [register the media libraries yourself](https://staticjscms.github.io/static-cms/blog/2019/07/netlify-cms-gatsby-plugin-4-0-0#using-media-libraries-with-netlify-cms-app). **Note:** You'll need to [register the media libraries yourself](/blog/2019/07/netlify-cms-gatsby-plugin-4-0-0#using-media-libraries-with-netlify-cms-app).
## Configuring the Uploadcare Widget ## Configuring the Uploadcare Widget

View File

@ -4,7 +4,7 @@ title: Overview
weight: 0 weight: 0
--- ---
Widgets define the data type and interface for entry fields. Static CMS comes with several built-in widgets. Click the widget names in the sidebar to jump to specific widget details. Were always adding new widgets, and you can also [create your own](/docs/custom-widgets)! Widgets define the data type and interface for entry fields. Static CMS comes with several built-in widgets. Click the widget names in the sidebar to jump to specific widget details. We're always adding new widgets, and you can also [create your own](/docs/custom-widgets)!
Widgets are specified as collection fields in the Static CMS `config.yml` file. Note that [YAML syntax](https://en.wikipedia.org/wiki/YAML#Basic_components) allows lists and objects to be written in block or inline style, and the code samples below include a mix of both. Widgets are specified as collection fields in the Static CMS `config.yml` file. Note that [YAML syntax](https://en.wikipedia.org/wiki/YAML#Basic_components) allows lists and objects to be written in block or inline style, and the code samples below include a mix of both.

View File

@ -201,7 +201,7 @@ Exception: Use “etc.” for et cetera.
### Avoid using “we” ### Avoid using “we”
Using “we” in a sentence can be confusing, because the reader might not know whether theyre part of the “we” youre describing. Using “we” in a sentence can be confusing, because the reader might not know whether they're part of the “we” you're describing.
> Do: Version 1.4 includes … > Do: Version 1.4 includes …