diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 35 |
1 files changed, 24 insertions, 11 deletions
@@ -2,11 +2,11 @@ <p align="center"><a href="https://github.com/mistermantas/cstate/releases"><img src="https://img.shields.io/github/release/mistermantas/cstate/all.svg?style=flat-square" alt="GitHub release" /></a> <a href="https://github.com/mistermantas/cstate/commits/master"><img src="https://img.shields.io/github/last-commit/mistermantas/cstate.svg?style=flat-square" alt="GitHub last commit" /></a> <a href="https://github.com/mistermantas/cstate/tree/master/"><img src="https://img.shields.io/github/repo-size/mistermantas/cstate.svg?style=flat-square" alt="GitHub repo size in bytes" /></a> <a href="https://gitter.im/cState/Lobby"><img src="https://img.shields.io/badge/chat-gitter-ed1965.svg?style=flat-square" alt="Gitter" /></a> <a href="https://twitter.com/mistermantas"><img src="https://img.shields.io/twitter/follow/mistermantas.svg?style=social&label=Follow" alt="Twitter" /></a></p> -> Über fast, backwards compatible (IE8+), tiny, and simple status page built with Hugo. Compatible with Netlify & GitHub Pages. +> Über fast, backwards compatible (IE8+), tiny, and simple status page built with Hugo. Completely free with Netlify & GitHub Pages. -*This release is a developer preview.* +[**Want an example? Click here to see a live demo!**](https://cstate-example.netlify.com) -[**Live demo**](https://themes.gohugo.io/theme/cstate/) +*Looking for contributors! See Contribute section:* ## Contents @@ -14,11 +14,13 @@ + Getting started + [Production](#production) + [Development](#development) - + [Updating](#updating) ++ [Updating](#updating) + [FAQ](#faq) + [Contribute](#contribute) + [License](#license) +*** + ## Features + Built with [Hugo](https://gohugo.io), a hyperfast Golang generator @@ -33,7 +35,7 @@ For this tutorial, it is assumed that you have Hugo and Git installed (check with `hugo version` & `git --version`). -#### Production (with Netlify) +#### 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: @@ -41,7 +43,9 @@ 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.31** + + Value: **0.41** + +*** 1. Download the contents of the `exampleSite` directory in this repository. This will be your site guts, which will hold the content and configuration for the status page. 2. Create a `themes` folder and navigate to it on the command line. @@ -56,7 +60,7 @@ mkdir themes; cd themes; git submodule add https://github.com/mistermantas/cstate ``` -4. Set up cState for your liking. It is now ready to be deployed +4. Set up cState for your liking. It is now ready to be used in production. #### Development @@ -75,10 +79,16 @@ cd cstate-master/exampleSite 3. Uncomment this line in `config.yml`: ```yml -# themesDir: ../.. +themesDir: ../.. ``` -3. Then try out the site! A link to it will be shown on screen. +4. Make sure that the folder name is the same as the `theme` value:d + +```yml +theme: cstate-master +``` + +5. Then try out the site! A link to it will be shown on screen. ```bash hugo serve @@ -114,9 +124,9 @@ Affected: Section: post --- -*Monitoring* - After hitting the ole reboot button Example Chat App is now recovering. We're going to continue to monitor as everyone reconnects. {{< track "2018-04-13 16:50:00" >}} +*Monitoring* - After hitting the ole reboot button Example Chat App is now recovering. We’re going to continue to monitor as everyone reconnects. {{< track "2018-04-13 16:50:00" >}} -*Investigating* - We're aware of users experiencing unavailable guilds and issues when attempting to connect. We're currently investigating. {{< track "2018-04-13 15:54:00" >}} +*Investigating* - We’re aware of users experiencing unavailable guilds and issues when attempting to connect. We're currently investigating. {{< track "2018-04-13 15:54:00" >}} ``` Time to break that down. @@ -131,10 +141,13 @@ Time to break that down. ## 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. + + 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/mistermantas/cstate/issues). + Write consistent, simple, readable code and precise documentation. + [Join the Gitter chat](http://discord.io/choraleapp) for help or discussion. ++ You may also the creator’s [mnts Discord](https://discord.gg/EvQZdhT). ## License |