-
Notifications
You must be signed in to change notification settings - Fork 394
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[chore] Improve quality of README copy and display (#735)
* Adds link to the sanity.io blog * [comms] Improve quality of README copy and display * Update README.md * README.md update * Add social and newsletter to readme.md * Update README.md * Update README.md * Add links, more prose and illustrations * Add more examples and links to them * Make titles and link texts more descriptive * Link to documentation with shortcuts to essential parts * Replace screenshot with illustration * Add shoutouts to community package maintainers * Add missing bracket * Misc (#736) - Remove Rich Date input plugin from list - Add section about our code of conduct + link - Link to the license file
- Loading branch information
1 parent
95985d2
commit ab72b95
Showing
1 changed file
with
124 additions
and
7 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,22 +1,139 @@ | ||
[![Sanity Logo](https://www.sanity.io/static/images/logo_red.svg?v=2)](https://www.sanity.io) | ||
<h1> | ||
<a href="https://www.sanity.io"> | ||
<img width="40%" alt="Sanity Logo" src="https://www.sanity.io/static/images/logo_red.svg?v=2"/> | ||
</a> | ||
</h1> | ||
|
||
[![Join the chat at https://gitter.im/sanity-io/sanity](https://badges.gitter.im/sanity-io/sanity.svg)](https://gitter.im/sanity-io/sanity?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) | ||
<h4> | ||
<a href="https://www.sanity.io">Sanity</a> is a real-time content infrastructure. The editor, built in JavaScript and React.js, lives in this repo. It connects to a scalable, hosted backend featuring a Graph Oriented Query Language (GROQ), asset pipelines and fast edge caches. | ||
</h4> | ||
|
||
### Sanity is a headless, real-time CMS where the front end is an open source React-based construction kit and the back end is a graph-oriented cloud datastore with a globally distributed CDN. | ||
<p> | ||
<a href="https://gitter.im/sanity-io/sanity"><img src="https://badges.gitter.im/sanity-io/sanity.svg"></a> | ||
</p> | ||
|
||
[![Screenshot](https://cdn.sanity.io/images/3do82whm/production/cllejaievr_1QvGplh3diVAteYXT8aRNtLV-2376x1260.png?fm=jpg)](https://www.sanity.io) | ||
## Table of contents | ||
|
||
* <a href="#getting-started">Getting Started</a> | ||
* <a href="#key-features">Key Features</a> | ||
* <a href="#useful-links-and-resources">Links and resources</a> | ||
* <a href="#code-of-conduct">Code of conduct</a> | ||
* <a href="#want-to-contribute">Contribute</a> | ||
* <a href="#license">License</a> | ||
|
||
|
||
[![Content Studio, Backend and Content Interfaces](https://public.sanity.io/modell_@2x.png)](https://www.sanity.io) | ||
|
||
## Getting started | ||
|
||
Get up and running with a Sanity-based CMS in minutes: | ||
If you are running Node the commands below install the Sanity CLI tooling and boostraps a new project for you. Not running Node? Have a look at [this](https://www.sanity.io/help/a5f6caba-53c9-4a9f-96ef-1bd1ae8f5c10). | ||
|
||
``` | ||
npm install -g @sanity/cli | ||
sanity init | ||
``` | ||
|
||
Then check out the [documentation](https://www.sanity.io/docs). | ||
Then check out the [schema documentation](https://www.sanity.io/docs/content-studio/the-schema) and customize your data structure. When you're happy, just `sanity deploy` to host the editor with us and head over to [sanity.io](https://www.sanity.io/manage) to invite editors. | ||
|
||
As they're merrily content managing you can start setting up a front-end to render your data based on one of the [demos](#sample-frontends) we have available. | ||
|
||
Feel totally free to [ping us on Gitter](https://gitter.im/sanity-io/sanity) for a chat should you have questions along the way! | ||
|
||
## Key Features | ||
|
||
#### [Content Studio](https://www.sanity.io/content-studio) | ||
|
||
* Efficient editing | ||
* Open source, MIT license | ||
* Real-time | ||
* Plug-in architecture | ||
* Block editor for structured content | ||
|
||
#### [Hosted Backend](https://www.sanity.io/hosted-backend) | ||
|
||
* Secure, scalable and compliant | ||
* Zero config Graph Oriented Query Language (GROQ) | ||
* Hard references for integrity | ||
* API & asset CDNs | ||
* Capable image pipeline | ||
|
||
## Useful links and resources | ||
|
||
### Documentation | ||
The [documentation](https://www.sanity.io/docs/introduction/getting-started) covers [how to work with content in Sanity](https://www.sanity.io/docs/introduction/the-sanity-way), [schema types](https://www.sanity.io/docs/reference/schema-types), [extending the content studio](https://www.sanity.io/docs/content-studio/extending), how to [query the API](https://www.sanity.io/docs/data-store/how-queries-work), [importing data](https://www.sanity.io/docs/data-store/importing-data) and [useful tips for presenting your content in a frontend](https://www.sanity.io/docs/front-ends). | ||
|
||
|
||
### Content Studio plugins | ||
|
||
#### Input types | ||
* [Google Maps input](https://www.sanity.io/docs/schema-types/geopoint-type) (`sanity install @sanity/google-maps-input`) | ||
* [Color input](https://www.npmjs.com/package/@sanity/color-input) (`sanity install @sanity/color-input`) | ||
* [Code input (syntax highlighted blocks)](https://www.npmjs.com/package/@sanity/code-input) (`sanity install @sanity/code-input`) | ||
|
||
#### Tools | ||
* [Vision - GROQ sandbox tool](https://www.npmjs.com/package/@sanity/vision) (`sanity install @sanity/vision`) | ||
|
||
### Schema plugins | ||
|
||
* [Podcast schema](https://www.npmjs.com/package/sanity-plugin-podcast#get-the-podcast-on-the-ether-headphones) (`sanity install podcast`) | ||
|
||
### Migration tools | ||
|
||
* [Tools for processing Sanity block content](https://www.npmjs.com/package/@sanity/block-tools) (`npm i @sanity/block-tools`) | ||
* [Convert Sanity block content into a genereic tree](https://www.npmjs.com/package/@sanity/block-content-to-tree) (`npm i @sanity/block-content-to-tree`) | ||
* [Migrate from Contentful to Sanity](https://github.com/sanity-io/contentful-to-sanity) (`npm install -g contentful-to-sanity`) | ||
|
||
### API Clients | ||
|
||
* [JavaScript](https://www.npmjs.com/package/@sanity/client) | ||
* [PHP](https://packagist.org/packages/sanity/sanity-php) | ||
|
||
#### Community contributed | ||
|
||
* [C# /.NET](https://github.com/onybo/sanity-client) (Thanks [@onybo](https://github.com/onybo)!) | ||
* [Laravel (PHP)](https://github.com/eastslopestudio/laravel-sanity) (Thanks [@eastslopestudio](https://github.com/eastslopestudio)!) | ||
|
||
### Sample frontends | ||
|
||
* [Next.js](https://github.com/sanity-io/example-frontend-next-js) | ||
* [React Native](https://github.com/sanity-io/example-app-react-native) | ||
* [Vue.js](https://github.com/sanity-io/example-frontend-vue-js) | ||
* [Silex + Twig](https://github.com/sanity-io/example-frontend-silex-twig) | ||
|
||
### Frontend rendering | ||
|
||
* [Block content to HTML](https://www.npmjs.com/package/@sanity/block-content-to-html) (`npm i @sanity/block-content-to-html`) | ||
* [Block content to React](https://www.npmjs.com/package/@sanity/block-content-to-react) (`npm i @sanity/block-content-to-react`) | ||
* [Block content to Hyperscript](https://www.npmjs.com/package/@sanity/block-content-to-hyperscript) (`npm i @sanity/block-content-to-hyperscript`) | ||
* [Quickly generate image urls from Sanity image records](https://www.npmjs.com/package/@sanity/image-url) (`sanity install @sanity/image-url`) | ||
|
||
### Blogs, tutorials and other reads | ||
|
||
* [The Sanity.io blog](https://sanity.io/blog) | ||
|
||
* [Tutorial: A Sanity backed blog with React and Next.js](https://www.sanity.io/blog/build-your-own-blog-with-sanity-and-next-js) | ||
* [Headless in Love with Sanity](https://hackernoon.com/headless-in-love-with-sanity-689960571dc) | ||
* [Headless in Love with Sanity](https://hackernoon.com/headless-in-love-with-sanity-689960571dc) | ||
* [Sanity with serverless Webtask and Google's Dialogflow ](https://hackernoon.com/put-your-chatbot-where-your-headless-cms-is-15cf174774c6) | ||
* [Build an Angular E-Commerce App on Top of Sanity's Headless CMS | ||
](https://snipcart.com/blog/headless-angular-ecommerce-app) | ||
|
||
### Stay up to date | ||
|
||
* Follow [@sanity_io](https://twitter.com/sanity_io) on Twitter | ||
* Subscribe to our [newsletter](http://eepurl.com/b2yaDz) | ||
|
||
![Content spread throughout the urban scape](https://public.sanity.io/modell_followup_1_@2x.png) | ||
|
||
## Code of Conduct | ||
We aim to be an inclusive, welcoming community for everyone. To make that explicit, we have a [code of conduct](https://github.com/sanity-io/sanity/blob/master/CODE_OF_CONDUCT.md) that applies to communication around the project. | ||
|
||
## Want to contribute? | ||
|
||
Found an issue, or want to contribute code? Please see our [Contributing guidelines](https://github.com/sanity-io/sanity/blob/master/CONTRIBUTING.md). | ||
Found a bug, or want to contribute code? Pull requests and issues are most welcome. You might want to take a look at our [Contributing guidelines](https://github.com/sanity-io/sanity/blob/master/CONTRIBUTING.md) also. | ||
|
||
## License | ||
|
||
The Sanity Content Studio is available under the [*MIT License*](https://github.com/sanity-io/sanity/blob/master/LICENSE) | ||
|
||
![](https://cdn.sanity.io/images/3do82whm/production/iFi4bnMdiVHd37lfdaRV6lZQ-1600x800.png?w=1000&h=350&fit=max) |