ahelal/avm

Ansible Version Manager (AVM)

title	permalink	layout
About	/about/	page

Installation

Just fork this repository and adjust the _config.yml to use with Github Pages and your page is done.

Features

• supports dark mode on macOS Mojave
• optional sidebar
• MathJax support
• no external ressources
• included archive page
• supports pagination
• feed generation
• responsive
• syntax highlighting
• supports comments via disqus or isso

Based on

• Hyde
• Minima
• Lagrange
• Font Awesome
• KaTeX
• Pygments

Installation (jekyll-remote-theme method)

You can use this theme with the jekyll-remote-theme plugin. Just create an empty repo, copy over the index.html file and add this to your _config.yml:

remote_theme: niklasbuschmann/[email protected]

plugins:
  - jekyll-remote-theme

Note: to enable icons you also need to copy over the _data folder.

Config

Your _config.yml could for example look like this:

title: "Blog Title"
author: "Blog Author"
description: "My personal blog about ... something"
permalink: /:title/
lang: "en"
excerpt_separator: "\n\n\n"
date_format: "%B %d, %Y"

# Layout

show_excerpts: true        # show article excerpts on the home page
show_frame: true           # adds a gray frame to the site
show_sidebar: false        # show a sidebar instead of the usual header

# Menu

navigation:                # accepts {file, title, url, icon, sidebaricon}
  - {file: "index.html"}
  - {file: "README.md"}

external:                  # shows a footer with social links - for available icons see fontawesome.com/icons
  - {title: Mail, icon: envelope, url: "mailto:[email protected]"}
  - {title: Github, icon: github, url: "https://github.com/niklasbuschmann/contrast"}
  - {title: Subscribe, icon: rss, url: "/feed.xml"}

comments:
#  disqus_shortname: ""    # see https://disqus.com/
#  isso_domain: ""         # see https://posativ.org/isso/

plugins:
 - jekyll-feed

MathJax

Contrast comes preinstalled with a leightweight alternative to MathJax called KaTeX. To display equations in a post simply set mathjax: true in the article's front matter.

License

public domain

Screenshots

avm's Issues

Requirements in setup wrapper script

Hi, could I use requirements also in the setup wrapper script and not only in the setup command?

And if I install passlib with pip install passlib (and not as requirement), will be used with every version of Ansible that I've installed via AVM?

Thank you.

Cannot install pip libs

Hi,

We're trying to install pip libs on our virtual env but keep getting errors.

Command used is

avm install --version 2.0.2.0 -r pip-requirements.txt

and pip-requirements.txt contains the following

setuptools
passlib

Output is as follows

[17:17:15] Setting AVM version 'local' directory ... ✅
[17:17:15] Checking general system has minumum requirements ... ✅
[17:17:15] Installing/upgrading virtualenv ... ✅
[17:17:16] Checking packages on your system has minumum requirements ... ✅
[17:17:16] 2.0.2.0 | Install python requirments file pip-requirements.txt ...
Setup failed 😢. 

As an additional debug step I also tried using the example requirements.txt file you use in your Integration tests. This results in the exact same output...

Can you help point us in the right direction?

[Edit]: Weirdly enough when I ran the command directly /Users/REDACTED/.avm/2.0.2.0/venv/bin/pip install --upgrade --requirement pip-requirements.txt then it works perfectly. This has solved my issue. But I'm still not sure why this didn't work using avm directly.

Many thanks

Python version

Apparently the installer requires python2. Probably this should be reflected in the README.