Commit graph

1828 commits

Author SHA1 Message Date
Dennis den Ouden-van der Horst
ee8777516e Remove custom YAML extension and update requirements
Deleted the custom 'include_remove_yaml' Sphinx extension and its configuration. Cleaned up YAML front matter from intro.md. Updated requirements.txt to use released teachbooks package, added sphinx-gated-directives, and removed duplicate or outdated dependencies.
2026-01-04 17:53:12 +01:00
Dennis den Ouden-van der Horst
68cf7ca756 Add extension to remove YAML front matter from includes
Introduced a custom Sphinx extension 'include_remove_yaml' to strip YAML front matter from included files. Updated _config.yml to register the extension, and added YAML front matter to intro.md for demonstration.
2026-01-04 17:41:29 +01:00
Dennis den Ouden-van der Horst
a4cb6d7090 Remove obsolete instruction notebooks and update ToC
Deleted instructie.ipynb, instructie_2.ipynb, and lesoefeningen.ipynb from the book. Updated _toc.yml to remove references to these files and moved the Sphinx-Gated-Directives manual link to the correct section. Minor update to intro.md.
2026-01-04 16:51:14 +01:00
Dennis den Ouden-van der Horst
ab38930bb3 Update TOC and requirements for TeachBooks changes
Added an external manual link to the table of contents. Updated requirements to use TeachBooks from the 'issue-127' branch and adjusted comments for clarity.
2026-01-04 16:20:16 +01:00
Dennis den Ouden-van der Horst
804bae0dee Add note inside axiom-end directive in intro
Inserted a line of text within the prf:axiom-end directive in intro.md to clarify that this text will not be rendered.
2026-01-04 13:05:52 +01:00
Dennis den Ouden-van der Horst
dda9732246 Update comment for TeachBooks-Favourites dependency
Changed the comment for the TeachBooks-Favourites git dependency from 'bump patches' to 'bump codex' to clarify the purpose of the dependency update.
2026-01-04 12:26:58 +01:00
Dennis den Ouden-van der Horst
abec15b938 Switch sphinx_gated_directives to external package
Removed the local sphinx_gated_directives extension and updated configuration to use the external package. Added Sphinx-Gated-Directives as a dependency in requirements.txt and adjusted _config.yml to load it as an extra extension.
2026-01-04 11:57:49 +01:00
Dennis den Ouden-van der Horst
688c16fe71 Remove custom code alignment CSS and update requirements
Deleted the code-align.css file that enforced left alignment for docutils code cells. Updated the requirements.txt comment for TeachBooks-Favourites to reference 'patches' instead of 'codex'.
2026-01-04 11:23:45 +01:00
Dennis den Ouden-van der Horst
c6e968a947 Update requirements.txt 2026-01-04 11:06:32 +01:00
Dennis den Ouden-van der Horst
3f6d1f1d1b Update _config.yml 2026-01-04 11:04:17 +01:00
Tom van Woudenberg
29fe49b63c zonder override 2026-01-03 15:46:57 +01:00
Tom van Woudenberg
2a78126224 change labels 2026-01-03 15:42:01 +01:00
Tom van Woudenberg
e22ea50d6d added gates 2026-01-03 15:35:40 +01:00
Dennis den Ouden-van der Horst
1ac94844a3 Refactor directive name construction for clarity
Extracted suffix_separator, suffix_start, and suffix_end from cfg to local variables for improved readability and maintainability in directive name construction.
2026-01-03 12:50:11 +01:00
Dennis den Ouden-van der Horst
e12183af9e Refactor _should_skip_name for clarity and efficiency
Extracted suffix_separator, suffix_start, and suffix_end from cfg at the start of the function to avoid repeated dictionary lookups and improve code readability.
2026-01-03 12:48:34 +01:00
Dennis den Ouden-van der Horst
f4ea60d42c Enhance sphinx_gated_directives with configurable suffixes and override logic
Refactor the sphinx_gated_directives extension to support configurable suffixes and separator for start/end directives, and add an 'override_existing' option for more flexible directive registration. Update the registry naming and logic throughout the extension, add configuration validation, and update the book config and intro to demonstrate new exercise directives and nesting.
2026-01-03 12:45:24 +01:00
Dennis den Ouden-van der Horst
144c7a95be Refactor sphinx_gated_directives and update intro.md examples
Improved code structure and comments in sphinx_gated_directives/__init__.py, clarified logic, and removed unused/legacy code. Updated intro.md to remove commented-out directive examples and replaced them with active ones for better demonstration and testing.
2026-01-03 10:30:39 +01:00
Dennis den Ouden-van der Horst
f481588509 Update child theorem to axiom and add Sphinx theme
Changed the label from 'A child theorem' to 'A child axiom' in the intro.md file for clarity. Added 'sphinx-tudelft-theme==1.2.1' to requirements.txt to specify the documentation theme.
2026-01-02 20:08:02 +01:00
Dennis den Ouden-van der Horst
f9e4a0f0b7 Improve gated directive nesting validation and docs
Added a robust validate_SE function to check for correct nesting of start and end directives, with detailed error reporting. Updated the CheckGatedDirectivesTransform to use this validation and improved error messages for mismatched or incorrectly nested directives. Extended intro.md with comprehensive examples of nested directives, including both valid and invalid cases, to document and test the new behavior. Also added the sphinx_tudelft_theme extension in _config.yml.
2026-01-02 20:05:44 +01:00
Dennis den Ouden-van der Horst
a5f014ddf6 Replace logo figure with nothing.svg in intro
Added a new SVG file 'nothing.svg' and updated the intro.md to use this image in place of the previous logo-wide.svg. Adjusted figure attributes and alt text accordingly.
2026-01-02 17:55:31 +01:00
Dennis den Ouden-van der Horst
bd47d63475 Remove debug logging and update intro content
Debug logging statements were removed from MergeGatedDirectivesTransform in sphinx_gated_directives. The intro.md file was updated to include new theorem and figure directive examples, code cells, and additional documentation content.
2026-01-02 17:40:03 +01:00
Dennis den Ouden-van der Horst
fddd493e39 Comment out legacy registry logic in sphinx_gated_directives
Commented out the code related to the 'sphinx_gated_directives_registry' in favor of using only the 'sphinx_gated_directives_super_registry'. Updated purge and transform logic accordingly. Added clarifying comments to code-align.css regarding left alignment enforcement.
2026-01-02 17:18:18 +01:00
Dennis den Ouden-van der Horst
c7486c0b42 Add sphinx_gated_directives extension and code-align CSS
Introduces the custom Sphinx extension 'sphinx_gated_directives' for start/end directive gating and validation, registering it in the Sphinx local extensions. Also adds a CSS file to enforce left alignment for code cells. Updates _config.yml to configure the new extension and set the documentation language to English.
2026-01-02 17:09:33 +01:00
Tom van Woudenberg
7533ef1c0b
Merge pull request #231 from TeachBooks/test-metadata-prerelease
Update requirements and fix BibTeX formatting
2025-12-23 16:02:16 +01:00
Tom van Woudenberg
233df5631e
BUMP without fixing versoin 2025-12-23 16:01:43 +01:00
Dennis den Ouden-van der Horst
b56ad3336b Update requirements and fix BibTeX formatting
Pinned TeachBooks-Favourites to version v1.7.3 in requirements.txt for reproducibility. Added a missing comma and newline in references.bib to correct BibTeX formatting.
2025-12-23 15:51:43 +01:00
Dennis den Ouden-van der Horst
64c1647ca5
Update references.bib 2025-12-23 13:23:12 +01:00
Tom van Woudenberg
70727a502e
Merge pull request #229 from TeachBooks/metadata-bibtex-support
Add TeachBooks logo reference to bibliography
2025-12-21 10:10:20 +01:00
Dennis den Ouden-van der Horst
0bac6738ea
Add TeachBooks logo reference to bibliography 2025-12-19 16:27:34 +01:00
Tom van Woudenberg
b3469006d4
reorder 2025-12-19 13:55:25 +01:00
Tom van Woudenberg
88c67fe4cd
fix url 2025-12-19 13:48:14 +01:00
Tom van Woudenberg
025b2ff5c7
Update plotyl instructions 2025-12-19 13:32:17 +01:00
Tom van Woudenberg
bd4516c25e
Merge pull request #228 from TeachBooks/add-last-updated-by-git
Add Sphinx last updated by git to favourites list
2025-12-17 13:16:14 +01:00
Dennis den Ouden-van der Horst
eeb71c404d
Update favourites.md 2025-12-17 13:10:24 +01:00
Tom van Woudenberg
ff67aa5572
Add Sphinx last updated by git to favourites list 2025-12-15 18:08:27 +01:00
Dennis den Ouden-van der Horst
9ac3763de0
Add comment to external link in _toc.yml 2025-12-09 10:51:46 +01:00
Dennis den Ouden-van der Horst
1311109ba3
Merge pull request #227 from TeachBooks/test-glue-disable
Test glue disable
2025-12-09 10:46:03 +01:00
Dennis den Ouden-van der Horst
ce760deb7b
Remove comment from external link in _toc.yml 2025-12-09 10:41:55 +01:00
Dennis den Ouden-van der Horst
7330aae9fd
Update external link in _toc.yml 2025-12-09 10:37:13 +01:00
Tom van Woudenberg
00e40c5be7
Update external link comment in _toc.yml 2025-12-08 20:32:06 +01:00
Tom van Woudenberg
774882515e
Update external link comment in _toc.yml 2025-12-08 20:17:03 +01:00
Tom van Woudenberg
19120550e9
Add comment to external link in _toc.yml 2025-12-08 20:10:25 +01:00
Tom van Woudenberg
2d7633c496
Fix link for Sphinx Metadata Figure in favourites.md
Updated the link for Sphinx Metadata Figure to point to the correct manual file format.
2025-12-08 20:08:47 +01:00
Tom van Woudenberg
a0636f0bc8
Update TeachBooks-Favourites dependency version
Updated the TeachBooks-Favourites dependency to a new version.
2025-12-08 20:05:50 +01:00
Tom van Woudenberg
45b20ffdc6 Update sphinx-iframes 2025-12-05 11:31:42 +01:00
Dennis den Ouden-van der Horst
5e55e84522
Merge pull request #225 from TeachBooks/test_metadata
Updates to fit with new notebook in figure-metadata
2025-12-03 14:29:39 +01:00
Tom van Woudenberg
73a4095358 Update _toc.yml 2025-12-03 12:38:47 +01:00
Tom van Woudenberg
0f48b93776 prepare for updates 2025-12-03 12:37:47 +01:00
Tom van Woudenberg
d42f4efa49 Merge branch 'test_metadata' of https://github.com/TeachBooks/manual into test_metadata 2025-12-03 12:31:18 +01:00
Tom van Woudenberg
c83987b8be Update requirements.txt 2025-12-03 12:30:49 +01:00