aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMantas <11616378+mistermantas@users.noreply.github.com>2018-07-23 13:12:20 +0300
committerMantas <11616378+mistermantas@users.noreply.github.com>2018-07-23 13:12:20 +0300
commitac553a567f930648a1f350d298d60ef091858c7a (patch)
treef8109278676debde9884befebe22ae3c39b5a48b
parentd7500b363fee49307304fa623f74649cb408b532 (diff)
Work towards a release candidate
-rw-r--r--README.md34
-rw-r--r--exampleSite/config.yml21
-rw-r--r--images/highlight.pngbin96928 -> 72664 bytes
-rw-r--r--layouts/index.html3
-rw-r--r--layouts/partials/custom/homepage-summary.html8
-rw-r--r--layouts/partials/footer.html9
-rw-r--r--layouts/partials/header.html7
-rw-r--r--layouts/partials/meta.html6
8 files changed, 72 insertions, 16 deletions
diff --git a/README.md b/README.md
index ba6a6e2..f8c8c48 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,3 @@
-
<p style="text-align:center">
![cState](https://raw.githubusercontent.com/mistermantas/cstate/master/images/highlight.png)
@@ -7,11 +6,11 @@
</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
@@ -24,6 +23,8 @@
+ [Contribute](#contribute)
+ [License](#license)
+***
+
## Features
+ Built with [Hugo](https://gohugo.io), a hyperfast Golang generator
@@ -38,7 +39,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:
@@ -46,7 +47,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.
@@ -61,7 +64,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
@@ -80,10 +83,16 @@ cd cstate-master/exampleSite
3. Uncomment this line in `config.yml`:
```yml
-# themesDir: ../..
+themesDir: ../..
+```
+
+4. Make sure that the folder name is the same as the `theme` value:d
+
+```yml
+theme: cstate-master
```
-3. Then try out the site! A link to it will be shown on screen.
+5. Then try out the site! A link to it will be shown on screen.
```bash
hugo serve
@@ -119,9 +128,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.
@@ -136,10 +145,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
diff --git a/exampleSite/config.yml b/exampleSite/config.yml
index c75c9b6..6bd09b9 100644
--- a/exampleSite/config.yml
+++ b/exampleSite/config.yml
@@ -6,6 +6,13 @@
# Welcome to the cState configuration file!
#
+# This is the configuration file for v2-rc1.
+# If you are using an earlier version, or one
+# in the future, such as v3, you may see errors
+# pop up when deploying a cState website.
+#
+# Now, onto the fun part.
+#
# Hugo is used for building the status page,
# so this file can be used to change how
# your status page should behave or look.
@@ -37,7 +44,7 @@
# What is your status page called?
# Shows up in the browser bar and meta tags
-title: Example Status
+title: cState Status
# What language is this page in?
# Only alters the html[lang] attribute
@@ -72,7 +79,7 @@ params:
description: The guts of the application.
-
name: Media Proxy
- description: This is the service responsible for serving images, audio, and video. It is reliant on Fastly.
+ description: This is the service responsible for serving images, audio, and video. It is reliant on our CDN.
# partial: custom/metrics
# What header design should we use?
@@ -180,10 +187,18 @@ buildFuture: true
# These options affect the core of cState.
# Please do not change them if you do not
# know what you are doing.
-theme: cstate-dev
+theme: cstate-master
# If you are developing locally and want
# to contribute to the cState Git repo,
# please uncomment this option but do not
# forget to re-comment it when
themesDir: ../..
+
+# This option tells cState what version
+# your config file is using.
+#
+# Never ever remove this, nor change it,
+# if you have not updated to any other
+# version.
+version: 2
diff --git a/images/highlight.png b/images/highlight.png
index 19dc9b2..a16c9ef 100644
--- a/images/highlight.png
+++ b/images/highlight.png
Binary files differ
diff --git a/layouts/index.html b/layouts/index.html
index f80dfe0..b937777 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -97,6 +97,9 @@
{{ end }}
</div>
+ {{ if .Site.Params.enableCustomHTML }}
+ {{ partial "custom/homepage-summary" . }}
+ {{ end }}
<!-- End main -->
</div>
diff --git a/layouts/partials/custom/homepage-summary.html b/layouts/partials/custom/homepage-summary.html
new file mode 100644
index 0000000..1dadab6
--- /dev/null
+++ b/layouts/partials/custom/homepage-summary.html
@@ -0,0 +1,8 @@
+<!--
+
+This file can be used to add custom HTML
+to your cState powered status page.
+
+https://github.com/mistermantas/cstate/wiki/Customization
+
+-->
diff --git a/layouts/partials/footer.html b/layouts/partials/footer.html
index d6b5486..f9c49d8 100644
--- a/layouts/partials/footer.html
+++ b/layouts/partials/footer.html
@@ -1,3 +1,6 @@
+{{ if .Site.Params.enableCustomHTML }}
+ {{ partial "custom/above-footer" . }}
+{{ end }}
<div class="footer">
<div class="contain">
@@ -8,6 +11,10 @@
<p>{{ .Site.Params.description }}</p>
<!-- Please keep this one around to help cState grow <3 -->
- <small class="copyright faded">Powered by <a href="https://github.com/mistermantas/cstate">cState</a></small>
+ <small class="copyright faded">Powered by <a href="https://github.com/mistermantas/cstate">cState <b>v2.0-rc1</b></a></small>
</div>
</div>
+
+{{ if .Site.Params.enableCustomHTML }}
+ {{ partial "custom/below-footer" . }}
+{{ end }}
diff --git a/layouts/partials/header.html b/layouts/partials/header.html
index 94bef80..cfe6109 100644
--- a/layouts/partials/header.html
+++ b/layouts/partials/header.html
@@ -1,3 +1,6 @@
+{{ if .Site.Params.enableCustomHTML }}
+ {{ partial "custom/above-header" . }}
+{{ end }}
{{ if .Site.Params.useLargeHeaderDesign }}
<div class="header header--large">
@@ -24,3 +27,7 @@
</div>
</div>
{{ end }}
+
+{{ if .Site.Params.enableCustomHTML }}
+ {{ partial "custom/below-header" . }}
+{{ end }}
diff --git a/layouts/partials/meta.html b/layouts/partials/meta.html
index 7b45778..b5b7568 100644
--- a/layouts/partials/meta.html
+++ b/layouts/partials/meta.html
@@ -45,6 +45,8 @@
box-sizing: inherit;
}
+ ::selection { background: #B4D5FF; }
+
hr {
border: 0;
border-bottom: 1px solid #ccc;
@@ -280,5 +282,7 @@
}
}
</style>
-
+ {{ if .Site.Params.enableCustomHTML }}
+ {{ partial "custom/meta" . }}
+ {{ end }}
</head>