Merge branch 'main' into feature/python-tutorial

Author: Jiggly-Balls

.github/workflows/ci.yml

@@ -2,7 +2,6 @@ name: CI
 
 on:
   pull_request:
-    branches: [main]
   push:
     branches: [main]
 

.pre-commit-config.yaml

@@ -26,7 +26,7 @@ repos:
         entry: uv run zensical build --strict --clean
         language: system
         pass_filenames: false
-        files: ^(docs/|zensical\.toml|pyproject\.toml|uv\.lock)
+        files: ^(docs/|overrides/|zensical\.toml|pyproject\.toml|uv\.lock)
 
   - repo: https://github.com/swiss-ai-center/mdwrap
     rev: 0.2.5

CONTRIBUTING.md

@@ -93,8 +93,8 @@ Values that appear on more than one page live in `[project.extra]` in `zensical.
 Join us at {{ discord_invite }}.
 ```
 
-Available: `discord_invite`, `eos_repo`, `site_repo`. Add more there rather than pasting a URL into
-six pages.
+Available: `discord_invite`, `eos_repo`, `site_repo`, `member_count`. Add more there rather than
+pasting a URL into six pages.
 
 ### What not to add
 

Makefile

@@ -1,4 +1,4 @@
-.PHONY: run, strict, pre-commit
+.PHONY: run strict pre-commit
 
 all: run
 

README.md

@@ -1,4 +1,4 @@
-# practical-python.org
+# practicalpython.org
 
 The website and documentation space for the Practical Python Discord community.
 
@@ -43,13 +43,19 @@ uv run --dev pre-commit run --all-files
 docs/
 ├── index.md               landing page
 ├── CNAME                  custom domain, copied to the site root on build
+├── robots.txt             Tells crawlers and bots where to go
 ├── stylesheets/           colour, font and hero overrides
+├── static/                logo and images
 ├── getting-started/       the entry point for new members
+├── python-tutorial/       the beginner tutorial
 ├── rules/                 server rules, code of conduct, moderation
 ├── resources/             learning material and setup guides
-└── projects/
-    ├── our-projects/      software the community maintains
-    └── build-something/   project challenges for members
+├── projects/
+│   ├── our-projects/      software the community maintains
+│   └── build-something/   project challenges for members
+└── code-adventure/        landing page for the Code Adventure puzzles!
+overrides/
+└── main.html              theme override adding Open Graph and other SEO tags
 scripts/
 └── refresh_member_count.py  updates the Discord member count before a deploy build
 zensical.toml              all site configuration, including the nav
@@ -75,11 +81,4 @@ Pull requests run `.github/workflows/ci.yml` — the same pre-commit checks you
 
 ## Dependencies
 
-One direct dependency, `zensical`, pinned through `uv.lock`. `requirements.txt` is generated from
-the lockfile for anyone who wants to read the tree without uv:
-
-```bash
-uv export --no-dev --no-hashes --no-emit-project -o requirements.txt
-```
-
-CI installs from the lockfile, not from `requirements.txt`.
+One direct dependency, `zensical`, pinned through `uv.lock`.

docs/CNAME

@@ -1 +1 @@
-practical-python.org
+practicalpython.org

docs/code-adventure/index.md

@@ -79,7 +79,7 @@ Do you love solving puzzles and learning something new? __Join us on a Code Adve
 
     :   __Corporate sponsorship opportunities are also available__.
 
-    [:simple-github:{ .lg .middle } __Github__](https://github.com/JefeThePug/Practical-Python-Code-Adventure)
+    [:simple-github:{ .lg .middle } __GitHub__](https://github.com/JefeThePug/Practical-Python-Code-Adventure)
 
     :   Curious about how the adventure was made? __Check out the project on GitHub__.
         If you like what you see, feel free to give it a :material-star:{ .lg .bottom }.

docs/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://practicalpython.org/sitemap.xml

docs/rules/channels.md

@@ -47,10 +47,10 @@ Commands work in most channels, but check before filling a help channel with bot
     /ticket
     ```
 
-!!! tip "It's a long list..."
+    !!! tip "It's a long list..."
 
-    The full list, with permissions and arguments, is in the
-    [Eos documentation](../projects/our-projects/eos.md).
+        The full list, with permissions and arguments, is in the
+        [Eos documentation](../projects/our-projects/eos.md).
 
 === "Run code in the chat!"
 

docs/rules/index.md

@@ -30,7 +30,7 @@ Harassment, slurs and bigotry get you removed without a warning ladder. See
 ## 2. Stay on topic
 
 Stick to the subject of the channel you're posting in. If your question doesn't fit anywhere
-obvious, ask anyway — we'd rather help you find your way then you not ask because you didn't know
+obvious, ask anyway — we'd rather help you find your way than you not ask because you didn't know
 where to ask.
 
 [Channels](channels.md) says what goes where.