WIP: Migrate getara.org

Change-Id: I8c5cb386d8814b02f6c9bed5a281817ebd496ea7
This commit is contained in:
David Moreau Simard 2018-11-20 18:31:15 -05:00
parent 5b12fa0c1f
commit 5ef3afc81a
No known key found for this signature in database
GPG Key ID: CBEB466764A9E621
8 changed files with 242 additions and 0 deletions

25
website/README.rst Normal file
View File

@ -0,0 +1,25 @@
ARA's website
=============
Hosted at `ara.recordsansible.org <https://ara.recordsansible.org>`_, the
website is built with `Hugo <https://gohugo.io/>`_ and installed with the
website role from this project's repository.
The website uses the Hugo theme called `future-imperfect <https://themes.gohugo.io/future-imperfect/>`_
and it must be checked out as part of building the site.
Development
-----------
Clone repositories::
# This repo
git clone https://git.openstack.org/openstack/ara-infra
# The Hugo theme (location is important but can be anything)
git clone https://github.com/jpescador/hugo-future-imperfect /tmp/themes/hugo-future-imperfect
Install Hugo following instructions from their `documentation <https://gohugo.io/getting-started/installing/>`_.
Run Hugo's standalone server::
hugo --config website/config.toml --contentDir website/content --themesDir /tmp/themes --layoutDir website/layouts server

125
website/config.toml Normal file
View File

@ -0,0 +1,125 @@
# https://gohugo.io/getting-started/configuration/
baseurl = "https://ara.recordsansible.org/"
languageCode = "en-us"
title = "ARA Records Ansible | ara.recordsansible.org"
theme = "hugo-future-imperfect"
preserveTaxonomyNames = true
paginate = 5
disqusShortname = ""
googleAnalytics = "UA-119558821-1"
pluralizeListTitles = false
enableRobotsTXT = true
canonifyURLs = true
[params]
# Sets the meta tag description
description = "ARA Records Ansible playbook runs and makes the recorded data available and intuitive for users and systems."
# Sets the navbarTitle that appears in the top left of the navigation bar
navbarTitle = "ARA Records Ansible"
# Sets where "View More Posts" links
viewMorePostLink = "/blog/"
# Optional Params
# Sets navbarTitle to match the section of the website
dynamicTitles = false
# Sets RSS icons to appear on the sidebar with the social media buttons
rssAppearAtTop = true
rssAppearAtBottom = true
# Sets Social Media icons to appear on the sidebar
socialAppearAtTop = true
socialAppearAtBottom = true
# Sets Categories to sort by number of posts instead of alphabetical
categoriesByCount = true
# set to show or to hide categories in the sidebar
showSidebarCategories = true
# Sets Estimated Reading Time to appear in post headers
includeReadingTime = true
# Sets the Favicon and Version for the site. Default support is for
# apple-touch-icon-precomposed.png, favicon.png, favicon.ico, and mstile.png.
# These are stored in the favicon folder. See the following for more information:
# https://github.com/audreyr/favicon-cheat-sheet
loadFavicon = true
faviconVersion = ""
# Sets Social Share links to appear on posts
socialShare = true
# Sets specific share to appear on posts (default behavior is to appear)
socialShareTwitter = true
socialShareGoogleplus = true
socialShareFacebook = true
socialShareReddit = true
socialShareLinkedin = true
socialShareStumbleupon = false
socialSharePinterest = false
socialShareEmail = true
# Load custom CSS or JavaScript files. The variable is an array so that you
# can load multiple files if necessary. You can also load the standard theme
# files by adding the value, "default".
# customCSS = ["default", "/path/to/file"]
# customJS = ["default", "/path/to/file"]
customCSS = ["default"]
customJS = ["default"]
# options for highlight.js (version, additional languages, and theme)
disable_highlight = false # set to true to disable Highlight
highlightjsVersion = "9.13.1"
highlightjsCDN = "//cdn.bootcss.com"
highlightjsLang = ["r", "yaml", "css"]
highlightjsTheme = "github"
[permalinks]
blog = "/blog/:year/:month/:day/:slug/"
[params.intro]
header = "/var/www/"
paragraph = "News and information about ARA Records Ansible"
about = "ARA Records Ansible playbook runs and makes the recorded data available and intuitive for users and systems."
# This appears at the top of the sidebar above params.intro.header.
# A width of less than 100px is recommended from a design perspective.
[params.intro.pic]
src = "static/logo.png"
# Sets Image to be a circle
circle = false
# Sets Image to be Future Imperfect's hexagon
imperfect = false
width = ""
alt = "ara.recordsansible.org"
[params.postAmount]
# Sets the number of recent posts to show in the sidebar. The default value is 5.
sidebar = 5
# Sets the menu items in the navigation bar
# Identifier prepends a Font Awesome icon to the menu item
[[menu.main]]
name = "Home"
url = "/"
identifier = "fa fa-home"
weight = 1
[[menu.main]]
name = "Blog"
url = "/blog/"
identifier = "fa fa-newspaper-o"
weight = 2
[[menu.main]]
name = "Documentation"
url = "https://ara.readthedocs.io"
identifier = "fa fa-book"
weight = 3
[[menu.main]]
name = "Community & Help"
url = "/community/"
identifier = "fa fa-users"
weight = 4
# Sets Social Media icons to appear and link to your account. Value should be your
# username unless otherwise noted. These are the icons affected by socialAppearAtTop
# and socialAppearAtBottom.
[social]
github = "openstack/?q=ara"
twitter = "ARecordsAnsible"

46
website/content/_index.md Normal file
View File

@ -0,0 +1,46 @@
---
kind: home
---
# What's ARA Records Ansible ?
ARA Records Ansible playbook runs and makes the recorded data available and intuitive for users and systems.
It saves everything to a local or remote database and provides tools to make your playbooks easier to understand and troubleshoot.
### ARA is a free and open source OpenStack community project
ARA is an [OpenStack](https://www.openstack.org) community project and all of it's [components](https://github.com/openstack?q=ara)
are free and open source under the GPLv3 license.
You can participate in [code reviews](https://review.openstack.org/#/q/project:%255Eopenstack/ara.*+OR+project:openstack/ansible-role-ara)
and learn how you can contribute your first patch in the [contributors documentation](https://ara.readthedocs.io/en/latest/contributing.html).
### ARA is simple and easy to use
ARA does one thing and it does it well: reporting on your Ansible playbooks.
[Install ARA](http://ara.readthedocs.io/en/stable/installation.html), tell [Ansible](https://ara.readthedocs.io/en/latest/configuration.html)
to use it and your next playbook will be recorded. That's it !
Read more about the project's core values in the [manifesto](https://ara.readthedocs.io/en/stable/manifesto.html).
### ARA is tested, stable and production ready
Each new commit to ARA is gated against a series of [unit and integration tests](https://github.com/openstack/ara#contributing-testing-issues-and-bugs)
against different Linux distributions and versions of Ansible in order to prevent regressions.
ARA is used to record more than a [million playbooks a month](http://superuser.openstack.org/articles/scaling-ara-ansible/) from the OpenStack community alone.
It works.
### ARA is offline and decentralized by default
Running Ansible from your laptop ? No problem.
You can browse your ARA reports locally from a sqlite database without ever leaving the comfort of localhost.
Need to scale with real [web and application servers](https://ara.readthedocs.io/en/stable/webserver.html) or use a
database server like [MySQL or PostgreSQL](https://ara.readthedocs.io/en/stable/configuration.html#ara-database) ?
You can do that too.

View File

@ -0,0 +1,29 @@
---
categories:
- meta
date: 2018-11-20
title: Community & Help
---
If you have questions, need help or would like to contribute, you can reach the
ARA community on IRC or Slack.
The IRC and Slack channels are transparently bridged with [teamchat](https://github.com/dmsimard/teamchat)
which broadcasts messages from one platform to the other.
# IRC
You can find us in ``#ara`` on the [freenode](https://freenode.net/) network.
If you do not have an IRC client, freenode provides a [webchat](http://webchat.freenode.net/?channels=%23ara)
which lets you connect through your internet browser.
# Slack
The Slack instance is hosted at [ARecordsAnsible.slack.com](https://arecordsansible.slack.com)
and you can join with this [invitation link](https://join.slack.com/t/arecordsansible/shared_invite/enQtMjMxNzI4ODAxMDQxLWU4MmZhZTI4ZjRjOTUwZTM2MzM3MzcwNDU1YzFmNzRlMzI0NTUzNDY1MWJlNThhM2I4ZTViZjUwZTRkNTBiM2I).
# Twitter
You can also follow [@ARecordsAnsible](https://twitter.com/ARecordsAnsible) on Twitter
to stay up to date with the latest news about the project.

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

View File

@ -0,0 +1,13 @@
{{ partial "header" . }}
{{ $.Scratch.Set "shareNav" true }}
{{ partial "navbar" . }}
<!-- Main -->
<div id="main">
<article class="post">
<div id="content">
{{ .Content }}
</div>
</article>
</div>
{{ partial "sidebar" . }}
{{ partial "footer" . }}

View File

@ -0,0 +1,4 @@
{{ if .Site.Params.loadFavicon }}
<link rel="icon" href='static/favicon.ico'>
<meta name="application-name" content="{{ .Site.Title }}">
{{ end }}