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