Add home

Author: RobertoPrevato

.github/workflows/main.yml

@@ -41,21 +41,12 @@ jobs:
           pip install -U pip
           pip install -r requirements.txt
 
-      - name: Build BlackSheep documentation
+      - name: Build and pack docs
         run: |
-          cd blacksheep
-          mkdocs build
-
-      - name: Zip built files
-        run: |
-          cd blacksheep
-          mkdir -p .build/blacksheep
-          mv site/* .build/blacksheep
-          cd .build
-          7z a -r site.zip blacksheep
+          ./pack.sh
 
       - name: Upload distribution package
         uses: actions/upload-artifact@v4
         with:
           name: dist
-          path: .build/site.zip
+          path: site.zip

.gitignore

@@ -2,6 +2,7 @@ site
 venv
 .build
 .env
+site.zip
 
 # temporary
 rodi

README.md

@@ -18,3 +18,18 @@ documentation.
 ```bash
 $ mkdocs serve
 ```
+
+## How to build the full site
+
+- Create a Python virtual environment, activate, install the dependencies.
+- Use `pack.sh` to build the full site.
+- `cd` into the generated `site` folder.
+- Start a dev servers. Recommended: use `Python http.server` module.
+
+```bash
+./pack.sh
+
+cd site
+
+python3.13 -m http.server 44777
+```

blacksheep/README.md

@@ -0,0 +1,3 @@
+# BlackSheep docs 📜
+
+[www.neoteroi.dev](https://www.neoteroi.dev/blacksheep/).

blacksheep/mkdocs.yml

@@ -85,7 +85,10 @@ extra_css:
 
 plugins:
   - search
-  - neoteroi.contribs
+  - neoteroi.contribs:
+      contributors:
+        - email: roberto.prevato@gmail.com
+          image: https://avatars.githubusercontent.com/u/2576032?s=400&u=d8d880e8ed05bb170877dd3d561d8301c4beeeed&v=4
 
 markdown_extensions:
   - admonition

home/README.md

@@ -0,0 +1,3 @@
+# Neoteroi-docs-home
+
+Source code for the homepage of [www.neoteroi.dev](https://www.neoteroi.dev).

home/docs/css/extra.css

@@ -0,0 +1,46 @@
+html {
+    overflow-y: scroll;
+}
+
+:root,
+[data-md-color-scheme=default],
+[data-md-color-scheme=slate] {
+    --md-primary-fg-color: #00435c;
+    --md-footer-bg-color: #00435c;
+}
+
+[data-md-color-scheme=slate] a {
+    --md-primary-fg-color: #76e4af;
+    --md-typeset-a-color: #76e4af;
+}
+
+[data-md-color-scheme=slate] a:hover {
+    --md-accent-fg-color: #fe5252;
+}
+
+[data-md-color-scheme=slate] a:hover {
+    --md-accent-fg-color: #5cd9b6;
+}
+
+
+.epic-timeline .nt-timeline-dot .icon {
+    color: white;
+    background: white;
+    border-radius: 50%;
+}
+
+#icons-credits>div {
+    max-width: 59rem;
+    margin: auto;
+    padding: .3rem;
+}
+
+.credits-note {
+    font-style: italic;
+    font-size: 0.7rem;
+}
+
+.nt-card-image[style*="oad.png"],
+.nt-card-image[style*="spantable.png"] {
+    background-position: top !important;
+}