Use jekyll for reference docs

This commit is contained in:
Jamil Bou Kheir
2021-10-04 11:12:45 -07:00
parent 3fce677255
commit d2753aecb4
9 changed files with 203 additions and 201 deletions

5
docs/.gitignore vendored Normal file
View File

@@ -0,0 +1,5 @@
_site
.sass-cache
.jekyll-cache
.jekyll-metadata
vendor

25
docs/404.html Normal file
View File

@@ -0,0 +1,25 @@
---
permalink: /404.html
layout: default
---
<style type="text/css" media="screen">
.container {
margin: 10px auto;
max-width: 600px;
text-align: center;
}
h1 {
margin: 30px 0;
font-size: 4em;
line-height: 1;
letter-spacing: -1px;
}
</style>
<div class="container">
<h1>404</h1>
<p><strong>Page not found :(</strong></p>
<p>The requested page could not be found.</p>
</div>

29
docs/Gemfile Normal file
View File

@@ -0,0 +1,29 @@
source "https://rubygems.org"
# Hello! This is where you manage which Jekyll version is used to run.
# When you want to use a different version, change it below, save the
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
#
# bundle exec jekyll serve
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
gem "jekyll", "~> 4.2.1"
# This is the default theme for new Jekyll sites. You may change this to anything you like.
gem "minima", "~> 2.5"
# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
# gem "github-pages", group: :jekyll_plugins
# If you have any plugins, put them here!
group :jekyll_plugins do
gem "jekyll-feed", "~> 0.12"
end
# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
platforms :mingw, :x64_mingw, :mswin, :jruby do
gem "tzinfo", "~> 1.2"
gem "tzinfo-data"
end
# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]

80
docs/Gemfile.lock Normal file
View File

@@ -0,0 +1,80 @@
GEM
remote: https://rubygems.org/
specs:
addressable (2.8.0)
public_suffix (>= 2.0.2, < 5.0)
colorator (1.1.0)
concurrent-ruby (1.1.9)
em-websocket (0.5.2)
eventmachine (>= 0.12.9)
http_parser.rb (~> 0.6.0)
eventmachine (1.2.7)
ffi (1.15.4)
forwardable-extended (2.6.0)
http_parser.rb (0.6.0)
i18n (1.8.10)
concurrent-ruby (~> 1.0)
jekyll (4.2.1)
addressable (~> 2.4)
colorator (~> 1.0)
em-websocket (~> 0.5)
i18n (~> 1.0)
jekyll-sass-converter (~> 2.0)
jekyll-watch (~> 2.0)
kramdown (~> 2.3)
kramdown-parser-gfm (~> 1.0)
liquid (~> 4.0)
mercenary (~> 0.4.0)
pathutil (~> 0.9)
rouge (~> 3.0)
safe_yaml (~> 1.0)
terminal-table (~> 2.0)
jekyll-feed (0.15.1)
jekyll (>= 3.7, < 5.0)
jekyll-sass-converter (2.1.0)
sassc (> 2.0.1, < 3.0)
jekyll-seo-tag (2.7.1)
jekyll (>= 3.8, < 5.0)
jekyll-watch (2.2.1)
listen (~> 3.0)
kramdown (2.3.1)
rexml
kramdown-parser-gfm (1.1.0)
kramdown (~> 2.0)
liquid (4.0.3)
listen (3.7.0)
rb-fsevent (~> 0.10, >= 0.10.3)
rb-inotify (~> 0.9, >= 0.9.10)
mercenary (0.4.0)
minima (2.5.1)
jekyll (>= 3.5, < 5.0)
jekyll-feed (~> 0.9)
jekyll-seo-tag (~> 2.1)
pathutil (0.16.2)
forwardable-extended (~> 2.6)
public_suffix (4.0.6)
rb-fsevent (0.11.0)
rb-inotify (0.10.1)
ffi (~> 1.0)
rexml (3.2.5)
rouge (3.26.1)
safe_yaml (1.0.5)
sassc (2.4.0)
ffi (~> 1.9)
terminal-table (2.0.0)
unicode-display_width (~> 1.1, >= 1.1.1)
unicode-display_width (1.8.0)
PLATFORMS
ruby
DEPENDENCIES
jekyll (~> 4.2.1)
jekyll-feed (~> 0.12)
minima (~> 2.5)
tzinfo (~> 1.2)
tzinfo-data
wdm (~> 0.1.1)
BUNDLED WITH
2.1.4

54
docs/_config.yml Normal file
View File

@@ -0,0 +1,54 @@
# Welcome to Jekyll!
#
# This config file is meant for settings that affect your whole blog, values
# which you are expected to set up once and rarely edit after that. If you find
# yourself editing this file very often, consider using Jekyll's data files
# feature for the data you need to update frequently.
#
# For technical reasons, this file is *NOT* reloaded automatically when you use
# 'bundle exec jekyll serve'. If you change this file, please restart the server process.
#
# If you need help with YAML syntax, here are some quick references for you:
# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
# https://learnxinyminutes.com/docs/yaml/
#
# Site settings
# These are used to personalize your new site. If you look in the HTML files,
# you will see them accessed via {{ site.title }}, {{ site.email }}, and so on.
# You can create any custom variable you would like, and they will be accessible
# in the templates via {{ site.myvariable }}.
title: Firezone Documentation
email: feedback-docs@firez.one
description: >- # this means to ignore newlines until "baseurl:"
Firezone Reference Documentation.
Open-source, WireGuard-based VPN server and firewall for Linux.
baseurl: "" # the subpath of your site, e.g. /blog
url: "https://docs.firez.one" # the base hostname & protocol for your site, e.g. http://example.com
twitter_username: firezonevpn
github_username: firezone
# Build settings
theme: minima
plugins:
- jekyll-feed
# Exclude from processing.
# The following items will not be processed, by default.
# Any item listed under the `exclude:` key here will be automatically added to
# the internal "default list".
#
# Excluded items can be processed by explicitly listing the directories or
# their entries' file path in the `include:` list.
#
# exclude:
# - .sass-cache/
# - .jekyll-cache/
# - gemfiles/
# - Gemfile
# - Gemfile.lock
# - node_modules/
# - vendor/bundle/
# - vendor/cache/
# - vendor/gems/
# - vendor/ruby/

View File

@@ -1,80 +0,0 @@
/*
* cf-green: 6ece00;
* cf-blue: 006ece;
* cf-purple: 6000ce;
* cf-orange: ce6000;
* cf-yellow: cec700;
* cf-red: ce0006;
*/
a {
text-decoration: none;
color: white;
}
a:visited {
text-decoration: none;
color: white;
}
img.logo {
position: fixed;
left: 2ch;
width: 5ch;
height: 5ch;
}
nav {
margin: auto;
padding-top: 0;
height: 6ch;
}
ul.nav-links {
display: flex;
flex-direction: row;
flex-wrap: wrap;
max-width: 70ch;
list-style-type: none;
margin: 0 auto;
padding: 0;
justify-content: space-between;
}
ul.nav-links li a {
display: block;
padding: 2ch 0;
}
body {
background-color: #006ece;
margin: 0;
padding: 0;
}
main {
margin: 0;
padding: 0;
width: 100%;
}
main section {
background-color: white;
}
div.content {
max-width: 70ch;
padding: 2ch;
margin: auto;
}
footer {
color: white;
margin: auto;
padding-top: 0;
height: 6ch;
height:
}
footer div {
margin: 0 auto;
padding: 2ch 0;
max-width: 70ch;
}

View File

@@ -1,68 +0,0 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
inkscape:version="1.0 (4035a4fb49, 2020-05-01)"
sodipodi:docname="logo.svg"
id="svg14"
version="1.1"
clip-rule="evenodd"
fill-rule="evenodd"
y="0px"
x="0px"
viewBox="0 0 23.6446 19.1606"
style="shape-rendering:geometricPrecision;text-rendering:geometricPrecision;image-rendering:optimizeQuality;"
xml:space="preserve"
fill="#000000"
width="100px"
height="100px"><metadata
id="metadata18"><rdf:RDF><cc:Work
rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" /><dc:title></dc:title></cc:Work></rdf:RDF></metadata><sodipodi:namedview
inkscape:current-layer="g12"
inkscape:window-maximized="1"
inkscape:window-y="0"
inkscape:window-x="0"
inkscape:cy="38.095238"
inkscape:cx="30.902778"
inkscape:zoom="10.08"
showgrid="false"
id="namedview16"
inkscape:window-height="1440"
inkscape:window-width="2560"
inkscape:pageshadow="2"
inkscape:pageopacity="0"
guidetolerance="10"
gridtolerance="10"
objecttolerance="10"
borderopacity="1"
bordercolor="#666666"
pagecolor="#ffffff" /><defs
id="defs4"><style
id="style2"
type="text/css">
.fil0 {fill:#000000}
</style></defs><g
id="g12"><path
style="fill:#cf5c00;fill-opacity:1"
id="path6"
d="M15.1887 0c4.69642,3.91162 -0.165501,12.5809 1.55021,16.0813 -3.52571,-5.05912 1.27791,-9.40684 -1.55021,-16.0813z"
class="fil0" /><path
style="fill:#8d1e00;fill-opacity:1"
id="path8"
d="M17.7931 7.52913c3.06981,1.99461 -0.615103,6.66813 1.34661,7.86443 1.98661,1.21161 1.76181,-3.82372 4.50492,-2.53201 -2.85611,-0.971704 -1.67131,5.02322 -5.21022,4.22542 -4.04992,-0.913004 0.986704,-7.35483 -0.641303,-9.55784z"
class="fil0" /><path
style="fill:#2b1200;fill-opacity:1"
id="path10"
d="M-0 14.3588c5.84662,-4.65822 13.8104,2.81691 17.5685,3.28401 4.83302,0.600603 3.54561,-4.98742 5.96463,-4.77922 -2.22901,0.268801 -0.891004,6.11293 -5.87452,6.29353 -5.42722,0.196701 -10.8419,-8.07783 -17.6586,-4.79832z"
class="fil0" /></g><g
inkscape:label="Layer 1"
id="layer1"
inkscape:groupmode="layer" /></svg>

Before

Width:  |  Height:  |  Size: 2.6 KiB

View File

@@ -1,53 +0,0 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Firezone: Firewall + Web Gui for WireGuard</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<main>
<header>
<img class="logo" src="img/logo.svg" alt="Firezone Logo">
<nav>
<ul class="nav-links">
<li>
<a href="#introduction">Introduction</a>
</li>
<li>
<a href="#installation">Installation</a>
</li>
<li>
<a href="#usage">Usage</a>
</li>
<li>
<a href="#contributing">Contributing</a>
</li>
</ul>
</nav>
</header>
<section>
<div class="content">
<h1>Firezone</h1>
<a name="introduction"></a>
<h2>Introduction</h2>
<a name="installation"></a>
<h2>Installation</h2>
<a name="usage"></a>
<h2>Usage</h2>
<a name="contributing"></a>
<h2>Contributing</h2>
</div>
</section>
<footer>
<div>
© 2020 Firezone LLC
</div>
</footer>
</main>
</body>
</html>

10
docs/index.markdown Normal file
View File

@@ -0,0 +1,10 @@
---
# Feel free to add content and custom Front Matter to this file.
# To modify the layout, see https://jekyllrb.com/docs/themes/#overriding-theme-defaults
layout: home
---
Firezone Documentation
WIP