Merge pull request #6 from ansibleguy/docs-infra

Docs infra

.gitignore

@@ -0,0 +1 @@
+docs/build/

docs/html_infra.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+
+if [ -z "$1" ]
+then
+  DEST_DIR='build'
+else
+  DEST_DIR="$1"
+fi
+
+set -euo pipefail
+
+function log() {
+  msg="$1"
+  echo ''
+  echo "### ${msg} ###"
+  echo ''
+}
+
+cd "$(dirname "$0")"
+
+SRC_DIR="$(pwd)"
+
+TS="$(date +%s)"
+TMP_DIR="/tmp/${TS}"
+mkdir -p "${TMP_DIR}"
+
+VENV_BIN='/tmp/.ag-docs-venv/bin/activate'
+if [ -f "$VENV_BIN" ]
+then
+  source "$VENV_BIN"
+fi
+
+log 'BUILDING DOCS'
+export PYTHONWARNINGS='ignore'
+sphinx-build -b html source/ "${TMP_DIR}/" >/dev/null
+
+log 'PATCHING METADATA'
+cp "${SRC_DIR}/meta/"* "${TMP_DIR}/"
+
+HTML_META_SRC="<meta charset=\"utf-8\" />"
+HTML_META="${HTML_META_SRC}<meta http-equiv=\"Content-Security-Policy\" content=\"default-src 'self'; img-src 'self' https://files.oxl.at; style-src 'self' https://files.oxl.at 'unsafe-inline'; script-src 'self' https://files.oxl.at 'unsafe-inline' 'unsafe-eval'; connect-src 'self';\">"
+HTML_META="${HTML_META}<link rel=\"icon\" type=\"image/webp\" href=\"https://files.oxl.at/img/oxl3_sm.webp\">"
+HTML_META_EN="${HTML_META}"  # <link rel=\"alternate\" href=\"https://docs.o-x-l.at\" hreflang=\"de\">
+# HTML_LOGO_LINK_SRC='href=".*Go to homepage"'
+# HTML_LOGO_LINK_EN='href="https://www.o-x-l.com" class="oxl-nav-logo" title="OXL IT Services Website"'
+HTML_TITLE_BAD_EN='Ansible Collection - NFTables  documentation'
+HTML_TITLE_OK='NFTables Ansible Collection'
+HTML_LANG_NONE='<html'
+HTML_LANG_EN='html lang="en"'
+
+cd "${TMP_DIR}/"
+
+sed -i "s|$HTML_META_SRC|$HTML_META_EN|g" *.html
+sed -i "s|$HTML_META_SRC|$HTML_META_EN|g" */*.html
+# sed -i "s|$HTML_LOGO_LINK_SRC|$HTML_LOGO_LINK_EN|g" *.html
+# sed -i "s|$HTML_LOGO_LINK_SRC|$HTML_LOGO_LINK_EN|g" */*.html
+sed -i "s|$HTML_LANG_NONE|<$HTML_LANG_EN|g" *.html
+sed -i "s|$HTML_LANG_NONE|<$HTML_LANG_EN|g" */*.html
+sed -i "s|$HTML_TITLE_BAD_EN|$HTML_TITLE_OK|g" *.html
+sed -i "s|$HTML_TITLE_BAD_EN|$HTML_TITLE_OK|g" */*.html
+
+log 'ACTIVATING'
+cd "$SRC_DIR"
+if [ -d "$DEST_DIR" ]
+then
+  rm -r "$DEST_DIR"
+fi
+mkdir -p "${DEST_DIR}/"
+
+mv "${TMP_DIR}/"* "${DEST_DIR}/"
+
+touch "${DEST_DIR}/${TS}"
+
+rm -rf "$TMP_DIR"
+
+log 'FINISHED'

docs/meta/robots.txt

@@ -0,0 +1,27 @@
+User-agent: anthropic-ai
+Disallow: /
+
+User-agent: Claude-Web
+Disallow: /
+
+User-agent: ClaudeBot
+Disallow: /
+
+User-agent: PerplexityBot
+Disallow: /
+
+User-agent: CCBot
+Disallow: /
+
+User-agent: Google-Extended
+Disallow: /
+
+User-agent: GPTBot
+Disallow: /
+
+User-agent: ChatGPT-User
+Disallow: /
+
+User-agent: *
+Disallow:
+Sitemap: sitemap.xml

docs/meta/sitemap.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+   <url><loc>https://nftables.ansibleguy.net/en/latest/</loc></url>
+
+   <url><loc>https://nftables.ansibleguy.net/en/latest/usage/1_install.html</loc></url>
+   <url><loc>https://nftables.ansibleguy.net/en/latest/usage/2_basic.html</loc></url>
+
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/1_basic.html</loc></url>
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/chain.html</loc></url>
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/list.html</loc></url>
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/rule.html</loc></url>
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/table.html</loc></url>
+   <!--
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/counter.html</loc></url>
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/limit.html</loc></url>
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/set.html</loc></url>
+   <url><loc>https://nftables.ansibleguy.net/en/latest/modules/var.html</loc></url>
+   -->
+</urlset>

docs/source/conf.py

@@ -10,9 +10,10 @@
 exclude_patterns = []
 html_theme = 'piccolo_theme'
 html_static_path = ['_static']
-html_logo = 'https://netfilter.org/images/netfilter-logo3.png'
+html_logo = 'https://files.oxl.at/logos/netfilter.png'
 html_favicon = '_static/img/logo.png'
-html_css_files = ['css/main.css']
+html_js_files = ['https://files.oxl.at/js/feedback.js']
+html_css_files = ['css/main.css', 'https://files.oxl.at/css/feedback.css']
 master_doc = 'index'
 display_version = True
 sticky_navigation = True
@@ -21,6 +22,7 @@
 }
 html_theme_options = {
     'banner_text': '<a href="https://github.com/ansibleguy/collection_nftables">Repository on GitHub</a> | '
-                   '<a href="https://github.com/ansibleguy/collection_nftables/issues/new/choose">Report errors</a>'
+                   '<a href="https://github.com/ansibleguy/collection_nftables/issues/new/choose">Report Errors</a> | '
+                   '<a href="https://www.o-x-l.com">Get Support</a>'
 }
 html_short_title = 'Ansible NFTables'

docs/venv.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+VENV_PATH='/tmp/.ag-docs-venv'
+
+python3 -m virtualenv "$VENV_PATH"
+source "${VENV_PATH}/bin/activate"
+
+pip install -r requirements.txt >/dev/null