Initial import
This commit is contained in:
commit
f63ce5bdd8
20 changed files with 3252 additions and 0 deletions
6
.gitignore
vendored
Normal file
6
.gitignore
vendored
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
|
||||||
|
public/
|
||||||
|
resources/
|
||||||
|
node_modules/
|
||||||
|
tech-doc-hugo
|
||||||
|
|
3
.gitmodules
vendored
Normal file
3
.gitmodules
vendored
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
[submodule "themes/docsy"]
|
||||||
|
path = themes/docsy
|
||||||
|
url = https://github.com/google/docsy.git
|
9
assets/scss/_variables_project.scss
Normal file
9
assets/scss/_variables_project.scss
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
/*
|
||||||
|
|
||||||
|
Add styles or override variables from the theme here.
|
||||||
|
|
||||||
|
*/
|
||||||
|
|
||||||
|
p {
|
||||||
|
text-align: justify;
|
||||||
|
}
|
159
config.toml
Normal file
159
config.toml
Normal 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
13
content/en/_index.html
Normal 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
13
content/en/blog/_index.md
Normal 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.
|
||||||
|
|
8
content/en/blog/news/_index.md
Normal file
8
content/en/blog/news/_index.md
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
|
||||||
|
---
|
||||||
|
title: "General News"
|
||||||
|
linkTitle: "News"
|
||||||
|
weight: 20
|
||||||
|
---
|
||||||
|
|
||||||
|
|
8
content/en/blog/news/switching-to-hugo.md
Executable file
8
content/en/blog/news/switching-to-hugo.md
Executable 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
|
||||||
|
---
|
8
content/en/blog/travels/_index.md
Normal file
8
content/en/blog/travels/_index.md
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
|
||||||
|
---
|
||||||
|
title: "Travels"
|
||||||
|
linkTitle: "Travels"
|
||||||
|
weight: 20
|
||||||
|
---
|
||||||
|
|
||||||
|
|
8
content/en/blog/travels/new-zealand.md
Executable file
8
content/en/blog/travels/new-zealand.md
Executable 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
12
content/en/docs/_index.md
Executable 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.
|
||||||
|
|
37
content/en/docs/about/_index.md
Normal file
37
content/en/docs/about/_index.md
Normal 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.
|
20
content/en/docs/adyxax.org/_index.md
Normal file
20
content/en/docs/adyxax.org/_index.md
Normal 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.
|
39
content/en/docs/adyxax.org/this_website.md
Normal file
39
content/en/docs/adyxax.org/this_website.md
Normal 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 >}}
|
4
content/en/search-index.md
Normal file
4
content/en/search-index.md
Normal file
|
@ -0,0 +1,4 @@
|
||||||
|
---
|
||||||
|
type: "search-index"
|
||||||
|
url: "index.json"
|
||||||
|
---
|
6
content/en/search.md
Normal file
6
content/en/search.md
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
---
|
||||||
|
title: Search Results
|
||||||
|
layout: search
|
||||||
|
|
||||||
|
---
|
||||||
|
|
8
layouts/404.html
Normal file
8
layouts/404.html
Normal 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
2866
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load diff
24
package.json
Normal file
24
package.json
Normal 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
1
themes/docsy
Submodule
|
@ -0,0 +1 @@
|
||||||
|
Subproject commit f060b7923fc82c93749b4eaa9656b6ec8496bfc8
|
Loading…
Add table
Reference in a new issue