handbook: first import

Author: gsanchietti

handbook/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# gem "rails"
+gem "logger"
+gem "jekyll"
+gem "github-pages", group: :jekyll_plugins
+
+gem "webrick", "~> 1.7"

handbook/Gemfile.lock

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# gem "rails"
+gem "logger"
+gem "jekyll"
+gem "github-pages", group: :jekyll_plugins
+
+gem "webrick", "~> 1.7"

handbook/README.md

@@ -0,0 +1,30 @@
+# Build the documentation
+
+The documentation is built using Github pages on each commit to the main branch.
+
+## Build locally
+
+Tested on Fedora 36 and Ubuntu 22.04.
+Install the dependencies make sure to install ruby >= 3.0.
+
+- Fedora:
+    ```
+    dnf module install ruby
+    dnf install gcc g++
+    ```
+
+- Ubuntu:
+    ```
+    apt install build-essential ruby-full
+    ```
+
+Install jekyll and all dependencies:
+```
+bundle config set --local path '.bundle/vendor'
+bundle install
+```
+
+Build and serve the site locally:
+```
+bundle exec jekyll serve
+```

handbook/_config.yml

@@ -0,0 +1,70 @@
+# Welcome to Jekyll!
+#
+# This config file is meant for settings that affect your whole site, values
+# which you are expected to set up once and rarely edit after that. If you find
+# yourself editing these 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
+# 'jekyll serve'. If you change this file, please restart the server process.
+
+# 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.github_repo }}, and so on.
+# You can create any custom variable you would like, and they will be accessible
+# in the templates via {{ site.myvariable }}.
+title: NS8 dev manual
+description: NS8 - Developer manual
+remote_theme: pmarsceill/just-the-docs
+
+baseurl: /ns8-core
+
+permalink: pretty
+exclude: [vendor]
+
+admin_manual: https://docs.nethserver.org/projects/ns8
+# Set a path/url to a logo that will be displayed instead of the title
+#logo: "/assets/images/just-the-docs.png"
+
+# Enable or disable the site search
+search_enabled: true
+
+# Set the search token separator for hyphenated-word search:
+search_tokenizer_separator: /[\s/]+/
+
+# Enable or disable heading anchors
+heading_anchors: true
+
+# Aux links for the upper right navigation
+aux_links:
+  "NS8 on GitHub":
+    - "//github.com/nethserver/ns8-core"
+
+# Footer content appears at the bottom of every page's main content
+footer_content: ""
+
+# Footer "Edit this page on GitHub" link text
+gh_edit_link: true
+gh_edit_link_text: "Edit this page on GitHub."
+gh_edit_repository: "https://github.com/NethServer/ns8-core"
+gh_edit_branch: "master"
+gh_edit_source: docs
+gh_edit_view_mode: "tree"
+
+# Color scheme currently only supports "dark" or nil (default)
+color_scheme: nil
+
+# Google Analytics Tracking (optional)
+# e.g, UA-1234567-89
+#ga_tracking: UA-2709176-10
+
+plugins:
+  - jekyll-seo-tag
+
+compress_html:
+  clippings: all
+  comments: all
+  endings: all
+  startings: []
+  blanklines: false
+  profile: false