From 4a968698e45ece04b25f41783298b9b397a191a1 Mon Sep 17 00:00:00 2001 From: Mantas <11616378+mistermantas@users.noreply.github.com> Date: Thu, 24 Jan 2019 19:23:35 +0200 Subject: cState is now stable on v3.0 - 2019-01-24 (info: #41) --- README.md | 75 +++++++++++++++++++++++++++++++++++++-------------------------- 1 file changed, 44 insertions(+), 31 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 95d0042..2c8c46c 100644 --- a/README.md +++ b/README.md @@ -1,43 +1,53 @@ -

cState

+

Example of what cState looks like

-

GitHub release GitHub last commit GitHub repo size in bytes Discord Chat Twitter Awesome README

+

GitHub release GitHub last commit GitHub repo size in bytes Discord Chat Twitter Awesome status page

-> Über fast, backwards compatible (IE8+), tiny, and simple status page built with Hugo. Completely free with Netlify & GitHub Pages. +> Über fast, backwards compatible (IE8+), tiny, and simple status page built with Hugo. Completely _free_ with Netlify & GitHub Pages. -[**Want an example? Click here to see a live demo!**](https://cstate-example.netlify.com) +[**🎯 Want an example? Click here to see a live demo!**](https://cstate-example.netlify.com) -[You can also see what an example cState project’s source code.](https://github.com/cstate/example) +[👩‍💻 You can also see what an example cState project’s source code.](https://github.com/cstate/example) -*Looking for contributors! See Contribute section:* +## Contents ⁉ -## Contents - -+ [Features](#features) -+ Getting started ++ [Features](#features-) ++ [Getting started](#getting-started-) + [Production](#production) + [Development](#development) -+ [Updating](#updating) -+ [FAQ](#faq) -+ [Contribute](#contribute) -+ [License](#license) ++ [Updating](#updating-) ++ [FAQ](#faq-) ++ [Contribute](#contribute-) ++ [License](#license-) *** -## Features +## Features 😎 + +**Designed with care** -+ Built with [Hugo](https://gohugo.io), a hyperfast Golang generator -+ Works not just on mobile, but also on the archaic Internet Explorer 8 + Comes with a simple, focused, and extremely light design ++ Works not just on mobile, but also on the archaic Internet Explorer 8 ++ Makes you accountable, showcasing how long it took for an issue to be resolved ++ Great for data manipulation and viewing — has RSS, tag-like system feeds + +**Fast, reliable, and free** + ++ Built with [Hugo](https://gohugo.io), a hyperfast Golang generator ++ Secure, ready for HTTPS, thanks to [JAMstack](https://jamstack.org/) ++ Easy to edit and deploy on Netlify for _absolutely free_ + +**Easy to setup, manage, use** + + Edit your status page from a simple config file + Comes pre-equipped with Netlify CMS for quick admin updates -+ Easy to edit and deploy on Netlify or GitHub Pages -+ Secure, ready for HTTPS, thanks to [JAMstack](https://jamstack.org/) + Extensive documentation on the [wiki](https://github.com/cstate/cstate/wiki) -## Getting started +## Getting started 💻 For this tutorial, it is assumed that you have Hugo and Git installed (check with `hugo version` & `git --version`). +> A minimum version of `0.48` is required for Hugo, starting with v3. + #### Production We encourage you to use [Netlify](https://www.netlify.com) for cState. These are the following options you need to change in deploy settings: @@ -46,7 +56,7 @@ We encourage you to use [Netlify](https://www.netlify.com) for cState. These are + Publish directory: **public** + Add one build environment variable + Key: **HUGO_VERSION** - + Value: **0.41** + + Value: **0.48** **The easy way** @@ -86,20 +96,20 @@ git clone https://github.com/cstate/cstate.git 2. Navigate to the theme directory: ```bash -cd cstate-master +cd cstate/exampleSite ``` 3. Launch the development setup much like this: ```bash -hugo serve --baseUrl=/ --theme=cstate-master --themesDir=../.. +hugo serve --baseUrl=http://localhost/ --theme=cstate --themesDir=../.. --verbose ``` The main directory is the theme itself (the cState guts, basically) and the `exampleSite` folder houses all content. Use this local setup to experiment before deploying to production! If you would like to commit/make a PR, make sure that `themesDir` is a comment before trying to merge upstream. -## Updating +## Updating 🎉 Assuming the production install instructions were followed, keep cState updated by having an up to date Git submodule in the `themes` folder. containing this repository. Your content will stay separate, as to avoid any conflicts. @@ -117,7 +127,7 @@ git clone --recursive && git submodule foreach git pu More info about submodules on [updating](https://stackoverflow.com/a/5828396) & [cloning](https://stackoverflow.com/questions/3796927/how-to-git-clone-including-submodules). -## FAQ +## FAQ 🤔 ### Where do issues go? @@ -127,7 +137,7 @@ This takes a little more effort to set up but pays off in the long run — [see #### Doing it from the Git repository -Create a file in `content/issues`. The name of the file will be the slug (what shows up in the URL bar). For example, this is what `major-outage-east-us.md` should look like: +Create a file in `content/issues`. The name of the file will be the slug (what shows up in the URL bar). For example, this is what `2017-02-30-major-outage-east-us.md` should look like: ```md --- @@ -160,15 +170,18 @@ Time to break that down. Check out [the wiki](https://github.com/cstate/cstate/wiki). -## Contribute +## Contribute 💥 -cState needs help to grow, not only would it benefit from stuff like unit tests, but also get influenced by fresh ideas to grow even further. +> Want to become a maintainer? Hit me up! [@mistermantas](https://twitter.com/mistermantas) + Glance over the [Code of Conduct](/CODE_OF_CONDUCT.md). + Before submitting a pull request, create an issue to [discuss the implications of your proposal](https://github.com/cstate/cstate/issues). ++ Or if you are a translator — [see this](https://github.com/cstate/cstate/wiki/Translations#add-your-translations). + Write consistent, simple, readable code and precise documentation. -+ You may also use the mnts [Discord chat](https://discord.gg/EvQZdhT) for support. ++ Version numbers should be added in JS partial & meta generator tags! + +## License ✍ -## License +[MIT](https://github.com/cstate/cstate/blob/master/LICENSE.md) © [Mantas Vilčinskas](https://github.com/mistermantas) -[MIT](https://github.com/cstate/cstate/blob/master/LICENSE.md) © Mantas Vilčinskas +Thanks to all the [contributors](https://github.com/cstate/cstate/graphs/contributors)! -- cgit v1.2.3-70-g09d2