WIP: Migrate getara.org
Change-Id: I8c5cb386d8814b02f6c9bed5a281817ebd496ea7
This commit is contained in:
parent
5b12fa0c1f
commit
5ef3afc81a
|
@ -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
|
|
@ -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"
|
|
@ -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.
|
|
@ -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 |
|
@ -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" . }}
|
|
@ -0,0 +1,4 @@
|
|||
{{ if .Site.Params.loadFavicon }}
|
||||
<link rel="icon" href='static/favicon.ico'>
|
||||
<meta name="application-name" content="{{ .Site.Title }}">
|
||||
{{ end }}
|
Loading…
Reference in New Issue