Initial import

This commit is contained in:
Julien Dessaux 2019-12-19 14:21:45 +01:00
commit f63ce5bdd8
20 changed files with 3252 additions and 0 deletions

6
.gitignore vendored Normal file
View file

@ -0,0 +1,6 @@
public/
resources/
node_modules/
tech-doc-hugo

3
.gitmodules vendored Normal file
View file

@ -0,0 +1,3 @@
[submodule "themes/docsy"]
path = themes/docsy
url = https://github.com/google/docsy.git

View file

@ -0,0 +1,9 @@
/*
Add styles or override variables from the theme here.
*/
p {
text-align: justify;
}

159
config.toml Normal file
View file

@ -0,0 +1,159 @@
baseURL = "/"
title = "Yet Another SysAdmin Wiki"
enableRobotsTXT = true
# Hugo allows theme composition (and inheritance). The precedence is from left to right.
theme = ["docsy"]
# Will give values to .Lastmod etc.
enableGitInfo = true
# Language settings
contentDir = "content/en"
defaultContentLanguage = "en"
defaultContentLanguageInSubdir = false
# Useful when translating.
enableMissingTranslationPlaceholders = true
disableKinds = ["taxonomy", "taxonomyTerm"]
# Highlighting config
pygmentsCodeFences = true
pygmentsUseClasses = false
# Use the new Chroma Go highlighter in Hugo.
pygmentsUseClassic = false
#pygmentsOptions = "linenos=table"
# See https://help.farbox.com/pygments.html
pygmentsStyle = "tango"
# Configure how URLs look like per section.
[permalinks]
blog = "/:section/:year/:month/:day/:slug/"
## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday
[blackfriday]
plainIDAnchors = true
hrefTargetBlank = true
angledQuotes = false
latexDashes = true
# Image processing configuration.
[imaging]
resampleFilter = "CatmullRom"
quality = 75
anchor = "smart"
[services]
[services.googleAnalytics]
# Comment out the next line to disable GA tracking. Also disables the feature described in [params.ui.feedback].
#id = "UA-00000000-0"
# Language configuration
[languages]
[languages.en]
title = "Yet Another SysAdmin Wiki"
description = "The wiki of yet another sysadmin"
languageName ="English"
# Weight used for sorting.
weight = 1
[languages.fr]
title = "Encore un wiki d'AdminSys"
description = "Docsy er operativsystem for skyen"
languageName ="French"
contentDir = "content/fr"
#time_format_default = "02.01.2006"
#time_format_blog = "02.01.2006"
[markup]
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true
# Everything below this are Site Params
[params]
copyright = "Julien (Adyxax) Dessaux"
#privacy_policy = "https://policies.google.com/privacy"
# First one is picked as the Twitter card image if not set on page.
# images = ["images/project-illustration.png"]
# Menu title if your navbar has a versions selector to access old versions of your site.
# This menu appears only if you have at least one [params.versions] set.
version_menu = "Releases"
# Repository configuration (URLs for in-page links to opening issues and suggesting changes)
#github_repo = "https://github.com/google/docsy-example"
# An optional link to a related project repo. For example, the sibling repository where your product code lives.
#github_project_repo = "https://github.com/google/docsy"
# Specify a value here if your content directory is not in your repo's root directory
# github_subdir = ""
# Google Custom Search Engine ID. Remove or comment out to disable search.
#gcs_engine_id = "011737558837375720776:fsdu1nryfng"
# Enable Algolia DocSearch
algolia_docsearch = false
# Enable Lunr.js offline search
offlineSearch = false
# User interface configuration
[params.ui]
# Enable to show the side bar menu in its compact state.
sidebar_menu_compact = false
# Set to true to disable breadcrumb navigation.
breadcrumb_disable = false
# Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled)
sidebar_search_disable = false
# Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar
#navbar_logo = true
# Set to true to disable the About link in the site footer
footer_about_disable = false
# Adds a H2 section titled "Feedback" to the bottom of each doc. The responses are sent to Google Analytics as events.
# This feature depends on [services.googleAnalytics] and will be disabled if "services.googleAnalytics.id" is not set.
# If you want this feature, but occasionally need to remove the "Feedback" section from a single page,
# add "hide_feedback: true" to the page's front matter.
[params.ui.feedback]
enable = false
# The responses that the user sees after clicking "yes" (the page was helpful) or "no" (the page was not helpful).
#yes = 'Glad to hear it! Please <a href="https://github.com/USERNAME/REPOSITORY/issues/new">tell us how we can improve</a>.'
#no = 'Sorry to hear that. Please <a href="https://github.com/USERNAME/REPOSITORY/issues/new">tell us how we can improve</a>.'
[params.links]
# End user relevant links. These will show up on left side of footer and in the community page if you have one.
#[[params.links.user]]
# name = "User mailing list"
# url = "https://example.org/mail"
# icon = "fa fa-envelope"
# desc = "Discussion and help from your fellow users"
#[[params.links.user]]
# name ="Twitter"
# url = "https://example.org/twitter"
# icon = "fab fa-twitter"
# desc = "Follow us on Twitter to get the latest news!"
#[[params.links.user]]
# name = "Stack Overflow"
# url = "https://example.org/stack"
# icon = "fab fa-stack-overflow"
# desc = "Practical questions and curated answers"
# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
#[[params.links.developer]]
# name = "GitHub"
# url = "https://github.com/google/docsy"
# icon = "fab fa-github"
# desc = "Development takes place here!"
#[[params.links.developer]]
# name = "Slack"
# url = "https://example.org/slack"
# icon = "fab fa-slack"
# desc = "Chat with other project developers"
#[[params.links.developer]]
# name = "Developer mailing list"
# url = "https://example.org/mail"
# icon = "fa fa-envelope"
# desc = "Discuss development issues around the project"

13
content/en/_index.html Normal file
View file

@ -0,0 +1,13 @@
+++
title = "Goldydocs"
linkTitle = "Goldydocs"
+++
{{< blocks/cover title="Welcome to Yet Another SysAdmin Wiki!" image_anchor="top" height="full" color="orange">}}
You can see this wiki as an aggregation of various information (but almost always SysAdmin related) and stuff I gathered around the Internet. When I have to work on something that needed some research, I put there a sum up of what I
have done, all along with personal thoughts. There will be documentation articles and maybe some blog posts if the documentation article is not suitable.
Well I hope you feel welcome here. I accept all good wills that might be motivated to add some material here. Do not hesitate to leave a message at adyxax -AT- adyxax.org, asking for
a translation or whatever ;-)
{{< /blocks/cover >}}

13
content/en/blog/_index.md Normal file
View file

@ -0,0 +1,13 @@
---
title: "Docsy Blog"
linkTitle: "Blog"
menu:
main:
weight: 30
---
This is the **blog** section. It has two categories: News and Travels.
Files in these directories will be listed in reverse chronological order.

View file

@ -0,0 +1,8 @@
---
title: "General News"
linkTitle: "News"
weight: 20
---

View file

@ -0,0 +1,8 @@
---
title: "Switching to Hugo"
linkTitle: "Switching to Hugo"
date: 2019-12-19
description: >
I switched my personal wiki from dokuwiki to Hugo
---

View file

@ -0,0 +1,8 @@
---
title: "Travels"
linkTitle: "Travels"
weight: 20
---

View file

@ -0,0 +1,8 @@
---
title: "I am back from New Zealand"
linkTitle: "Back from New Zealand"
date: 2019-12-08
description: >
I am back from New Zealand, after three and a half weeks over there.
---

12
content/en/docs/_index.md Executable file
View file

@ -0,0 +1,12 @@
---
title: "Documentation"
linkTitle: "Documentation"
weight: 20
menu:
main:
weight: 20
---
This section is where the user documentation for your project lives - all the information your users need to understand and successfully use your project.

View file

@ -0,0 +1,37 @@
---
title: "About"
linkTitle: "About"
weight: 1
description: >
Information about this site and the author
---
## Who am I?
Hello, and thanks for asking! My name is Julien Dessaux, and I am a 34 years old guy working in IT. Adyxax is the nickname I use on IRC, github, etc.
## Online presence
You won't find me on social networking websites. I have a Linkedin account that I don't use and that's it. I tried to make social networking work when I installed a pleroma instance
for my own use but I ended up trashing it. I just don't get this aspect
of modern society. I hang out with my friends when I want to hang out with them, and each time it's a blast : we talk about our lives, what happened to us. We share photos and
stories while having a beer and it's really great that way : I don't want to change any of that.
## Professional Career
I'm currently employed as a System and Network Architect at an awesome company named AlterWay, after 7 years at another awesome company named Intersec where I lead the IT team.
## Intersec
When I joined Intersec in September 2009 as the first full time system administrator we were just about 15 people. When I left in 2016 it had grown up to more than 160 people with
branch offices in three countries, and I am glad I was along for the ride. I have been the head of IT for about four years, participating in Intersec's growth by scaling the
infrastructure, deploying new services (Remote access, self hosted email, backups, monitoring, etc.), and recruiting my teammates. I left Intersec looking for new challenges and
for a new life away from the capital. Paris is one of the best cities on earth, but I needed a change and left for Lyon.
## AlterWay
I joined Alterway in October 2016 for a more technical role and a bit of a career shift towards networking. It has been and still is a great experience.
## How to get in touch
You can write me an email at julien[dot]dessaux[at]adyxax[dot]org, I will answer.

View file

@ -0,0 +1,20 @@
---
title: "adyxax.org"
linkTitle: "adyxax.org"
weight: 1
description: >
adyxax.org is how I call my personal computer infrastructure.
---
## What is adyxax.org?
adyxax.org is how I call my personal computer infrastructure. It is very much like a small personnal private cloud of servers hosted here and there. I am using my experience as a
sysadmin to make it all work and provide various services that are useful to me and people close to me.
It relies on gentoo and openbsd servers interconnected with point to point openvpn links. Services run inside lxd containers and communications between all those services is assured
thanks to dynamic routing with bird and ospf along those openvpn links.
## Why write about it?
It is a rather unusual infrastructure that I am proud of, and writing about it helps me to reflect on what I built. Gentoo, OpenBSD and LXD is not the most popular combination of
technologies but it allowed me to build something simple, flexible and I believe somewhat elegant and beautiful.

View file

@ -0,0 +1,39 @@
# This website
This website is a static website build using [hugo](https://github.com/gohugoio/hugo). This article details how I installed hugo, how I initialised this website and how I manage it.
## Installing hugo
{{< highlight sh >}}
go get github.com/gohugoio/hugo
{{< / highlight >}}
This failed because the master branch in one of the dependencies was tainted, I fixed it with :
{{< highlight sh >}}
cd go/src/github.com/tdewolff/minify/
tig --all
git checkout v2.6.1
go get github.com/gohugoio/hugo
{{< / highlight >}}
This didn't build me the extended version of hugo that I need for the theme I chose, so I had to do :
{{< highlight sh >}}
cd ~/go/src/github.com/gohugoio/hugo/
go get --tags extended
go install --tags extended
{{< / highlight >}}
## Bootstraping this site
{{< highlight sh >}}
hugo new site www
cd www
git init
git submodule add https://github.com/alex-shpak/hugo-book themes/book
{{< / highlight >}}
## Live server for automatic rebuilding when writing
{{< highlight sh >}}
hugo server --bind 0.0.0.0 --minify
{{< / highlight >}}

View file

@ -0,0 +1,4 @@
---
type: "search-index"
url: "index.json"
---

6
content/en/search.md Normal file
View file

@ -0,0 +1,6 @@
---
title: Search Results
layout: search
---

8
layouts/404.html Normal file
View file

@ -0,0 +1,8 @@
{{ define "main"}}
<main id="main">
<div>
<h1 id="title">Not found</h1>
<p>Oops! This page doesn't exist. Try going back to our <a href="{{ "/" | relURL }}">home page</a>.</p>
</div>
</main>
{{ end }}

2866
package-lock.json generated Normal file

File diff suppressed because it is too large Load diff

24
package.json Normal file
View file

@ -0,0 +1,24 @@
{
"name": "tech-doc-hugo",
"version": "0.0.1",
"description": "Hugo theme for technical documentation.",
"main": "none.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"repository": {
"type": "git",
"url": "git+https://github.com/bep/tech-doc-hugo.git"
},
"author": "",
"license": "ISC",
"bugs": {
"url": "https://github.com/bep/tech-doc-hugo/issues"
},
"homepage": "https://github.com/bep/tech-doc-hugo#readme",
"dependencies": {},
"devDependencies": {
"autoprefixer": "^9.7.3",
"postcss-cli": "^5.0.1"
}
}

1
themes/docsy Submodule

@ -0,0 +1 @@
Subproject commit f060b7923fc82c93749b4eaa9656b6ec8496bfc8