New docs/environments.md, nav 'Virtual environments' (before Deploy): - the rule: never touch system Python (danger callout) - project-based isolation as Local .venv / Makefile-driven / Docker tabs, each with a runnable snippet; Docker ties back to the deploy standard - local dev with pyenv: why, official install link, shell init with annotated lines, everyday use, per-project .python-version - shell quality-of-life extras (flake8 alias, .local/bin + npm-global PATH), cross-ref'd to Standards and Workflow workflow.md pyenv bullet now points at the new page; index.md gains a card. Verified in-browser: tabs switch (Local/Makefile/Docker), annotations and admonitions render; mkdocs build --strict clean (cross-ref anchors resolve). Signed-off-by: disqualifier <dev@disqualifier.me>
59 lines
1.3 KiB
YAML
59 lines
1.3 KiB
YAML
site_name: rethink development
|
|
site_description: Libraries, coding standards, and how to deploy on our network.
|
|
site_url: https://docs.rethinkstudios.io/
|
|
copyright: rethink development (handbook)
|
|
|
|
extra_css:
|
|
- stylesheets/extra.css
|
|
|
|
theme:
|
|
name: material
|
|
language: en
|
|
logo: assets/logo.svg
|
|
favicon: assets/logo.svg
|
|
palette:
|
|
scheme: slate
|
|
primary: custom
|
|
accent: custom
|
|
features:
|
|
- navigation.instant
|
|
- navigation.tracking
|
|
- navigation.top
|
|
- toc.follow
|
|
- search.suggest
|
|
- search.highlight
|
|
- content.code.copy
|
|
- content.code.annotate
|
|
icon:
|
|
repo: fontawesome/brands/git-alt
|
|
|
|
markdown_extensions:
|
|
- admonition
|
|
- attr_list
|
|
- md_in_html
|
|
- tables
|
|
- toc:
|
|
permalink: true
|
|
- pymdownx.details
|
|
- pymdownx.superfences
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
- pymdownx.highlight:
|
|
anchor_linenums: true
|
|
- pymdownx.inlinehilite
|
|
- pymdownx.snippets
|
|
- pymdownx.emoji:
|
|
emoji_index: !!python/name:material.extensions.emoji.twemoji
|
|
emoji_generator: !!python/name:material.extensions.emoji.to_svg
|
|
|
|
plugins:
|
|
- search
|
|
|
|
nav:
|
|
- Home: index.md
|
|
- Libraries: libraries.md
|
|
- Standards: standards.md
|
|
- Workflow: workflow.md
|
|
- Virtual environments: environments.md
|
|
- Deploy: deploy.md
|