* Update icons to use Tabler and apply the new Twitter logo.
Switch to Tabler because Prometheus 3.0 uses it, and Font Awesome's
latest open-source version doesn't include all necessary icons.
Signed-off-by: Julien <roidelapluie@o11y.eu>
* Remove twitter
Signed-off-by: Julien <roidelapluie@o11y.eu>
---------
Signed-off-by: Julien <roidelapluie@o11y.eu>
So far every prometheus/alertmanater/... release branch had to be
manually configured in the nanoc.yaml config file. With this change the
most recent release branches will be checked out automatically if a
corresponding semver tag exists.
As the Prometheus git repository includes several hundreds of megabytes
of vendored assets, the repository is cloned bare and all blobs are
filtered by default. Each version is then checked out in an individual
working tree and git's spare-chekcout feature is used to reduce the
checkout to the `docs/` folder. The git data is cached in
`tmp/repo_docs/` and will be recreated automatically if removed.
Signed-off-by: Tobias Schmidt <tobidt@gmail.com>
* Add prometheus-version docsearch meta tag to pages
I hope this will cause the Aloglia indexing engine to add a
"prometheus-version" indexing facet to our pages, so that when adding
Algolia search to the site in a subsequent step (I can already test it
locally), we can use this to search only for pages that are either the
latest Prometheus version (otherwise we get 10x the same-looking
result), or have no Prometheus version at all (the doc pages outside of
the versioned Prometheus sub-tree). I need to explicitly add "none" as a
version for the non-versioned pages, as Algolia search doesn't allow
facet filtering on null / undefined values.
Signed-off-by: Julius Volz <julius.volz@gmail.com>
* Fix "unversioned" -> "none"
Signed-off-by: Julius Volz <julius.volz@gmail.com>
* Point out that docs are open source and can be edited
Signed-off-by: Julius Volz <julius.volz@gmail.com>
* Add contribution clarifications to README.md, link to it
Signed-off-by: Julius Volz <julius.volz@gmail.com>
and instead make a new "page" layout for markdown-based pages. This
avoids changing the HTML based pages which are using the "default"
layout currently.
Let the governance use the default layout (all markdown files default to
"docs").
Make the default layout use the right div classes so the CSS can take
hold.
Fix the `layout` declaration for Markdown documents that are not `kind:
article`. Declare the governance to use the "default" layout, not the
"docs" one. This is the minimal change to support the governance
document. The layout choice needs a refactoring, but how to do that
needs more thought.
This adds a new download section to the page with list for all available
precompiled versions for officially maintained components. The release
information are fetched via the Github API and rendered as static list.
Currently only the latest release and the newest pre-release (if
available) are show. This could be extended later. In order to keep the
list usable besides the massive list of prebuilt binaries, a javascript
os/arch filter has been added, defaulting to popular versions.
The following changes have been made on the way:
* Ensure all pages have a footer.
* Remove duplicated jquery inclusion.
* Use CSS to define text case of jumbotron buttons.
* Add Download section to the header.
* Reduce Github link to just the logo to save space.
* Update Getting Started and Installing sections.
Routing tree editor is now only available as a
link from within the configuration docs for
alertmanager.
Code changes:
- Routing tree CSS is now in a CSS file
- The label set input now draws the route when
"enter" is pressed
- Thinner and more elegant fonts on landing page.
- Removed "Overview" menu item, shortened "Documentation" to "Docs".
- Replaced jumbotron logo+title with motivational text.
- Removed "View details" buttons on landing page, make features clickable
instead.
- Introduced testimonial quote section on landing page.
- Introduced "Open Source" section on landing page.
- Refactored overall jumbotron layout/content.
- Removed PromCon 2016 button.
- Changed documentation font to smaller size.
- Adjusted header font sizes and weights.
- Made code blocks look cooler, with orange left border.
- Don't wrap long lines in code blocks.
- Harmonized background colors between pre, code, and toc.
- Aligned the navbar Prometheus logo with the docs menu.
Prometheus is an independent project and some of the current SoundCloud
mentions serve more to confuse/make people insecure about using
Prometheus than they help. This adjusts the language and mentions a bit.
This is based roughly on
http://clarkdave.net/2012/02/building-a-static-blog-with-nanoc/
with a lot of small modifications to make it fit the existing docs site.
Blog posts should be added as:
content/blog/YYYY-MM-DD-post-title.md
They need to state the title, kind, created_at, and author in the
frontmatter, e.g.:
---
title: "This is a blog post title"
created_at: 2015-04-22
kind: article
author: Julius Volz
---
