Skip to content

Commit b10e021

Browse files
zamkoruszamkorus
committed
fixed navbar bug
1 parent 35ec322 commit b10e021

42 files changed

Lines changed: 4627 additions & 2 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# EI Manuals
1+
# [EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)
22

33
This repository contains the Jupyter Book source for the **NB2420 Electronic Instrumentation** manuals. The content is organised as a teaching manual rather than as a generic software template: the book combines introductory equipment guides, week-based practicum manuals, shared assets, and build configuration for publishing the material as a website.
44

‎book/_config.yml‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -158,7 +158,15 @@ sphinx:
158158
thebe_config:
159159
use_thebe_lite: true
160160
exclude_patterns: ["**/_*.yml", "**/*.md", "**/*.ipynb"]
161-
html_theme_options:
161+
html_theme_options:
162+
# Keep the search box in the sidebar only, deterministically across theme versions.
163+
# pydata-sphinx-theme >= 0.17 force-injects a persistent header "search-button-field"
164+
# (desktop and mobile copies) whenever this key is absent from html_theme_options,
165+
# which overrides the empty default set by sphinx-book-theme and produces a second and
166+
# third search field in a top navbar. Older pydata (<= 0.16) did not, so builds with an
167+
# unpinned/cached theme rendered inconsistently. Setting it explicitly to empty removes
168+
# the header search on every theme version while the sidebar search is unaffected.
169+
navbar_persistent: []
162170
logo:
163171
text: NB2420 practical
164172
image_light: static/icons/alpaca.svg

‎book/manuals/week4/4.1_opamp_basics.ipynb‎

100755100644
File mode changed.

‎book/manuals/week4/images/opamp_DIP8.svg‎

100755100644
File mode changed.

‎graphify-out/.graphify_labels.json‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
{
2+
"0": "How to use the EI manuals",
3+
"1": "[EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)",
4+
"2": "Standard admonition types",
5+
"3": "Repository instructions for AI agents",
6+
"4": "Custom admonitions used in this book",
7+
"5": "Default manual structure",
8+
"6": "Credits and License",
9+
"7": "Writing and style guidelines",
10+
"8": "EstimatedTimeAdmonition",
11+
"9": "EI manuals week 1",
12+
"10": "EI manuals week 11",
13+
"11": "EI manuals week 12",
14+
"12": "EI manuals week 13",
15+
"13": "EI manuals week 14",
16+
"14": "EI manuals week 16",
17+
"15": "EI manuals week 17",
18+
"16": "EI manuals week 18",
19+
"17": "EI manuals week 19",
20+
"18": "EI manuals week 2",
21+
"19": "EI manuals week 3",
22+
"20": "EI manuals week 4",
23+
"21": "EI manuals week 6",
24+
"22": "EI manuals week 7",
25+
"23": "EI manuals week 8",
26+
"24": "EI manuals week 9",
27+
"25": "warning.js",
28+
"26": "convert_mp4_to_avif.sh",
29+
"27": "EI_octal1.md",
30+
"28": "EI_octal2.md",
31+
"29": "EI_octal3.md",
32+
"30": "EI_octal4.md",
33+
"31": "electronic-instrumentation"
34+
}

‎graphify-out/.graphify_root‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
.

‎graphify-out/GRAPH_REPORT.md‎

Lines changed: 190 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,190 @@
1+
# Graph Report - Electronic_Instrumentation_manuals (2026-07-24)
2+
3+
## Corpus Check
4+
- 32 files · ~651,916 words
5+
- Verdict: corpus is large enough that graph structure adds value.
6+
7+
## Summary
8+
- 171 nodes · 143 edges · 32 communities (25 shown, 7 thin omitted)
9+
- Extraction: 99% EXTRACTED · 1% INFERRED · 0% AMBIGUOUS · INFERRED: 1 edges (avg confidence: 0.5)
10+
- Token cost: 0 input · 0 output
11+
12+
## Graph Freshness
13+
- Built from commit: `35ec3224`
14+
- Run `git rev-parse HEAD` and compare to check if the graph is stale.
15+
- Run `graphify update .` after code changes (no API cost).
16+
17+
## Community Hubs (Navigation)
18+
- How to use the EI manuals
19+
- [EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)
20+
- Standard admonition types
21+
- Repository instructions for AI agents
22+
- Custom admonitions used in this book
23+
- Default manual structure
24+
- Credits and License
25+
- Writing and style guidelines
26+
- EstimatedTimeAdmonition
27+
- EI manuals week 1
28+
- EI manuals week 11
29+
- EI manuals week 12
30+
- EI manuals week 13
31+
- EI manuals week 14
32+
- EI manuals week 16
33+
- EI manuals week 17
34+
- EI manuals week 18
35+
- EI manuals week 19
36+
- EI manuals week 2
37+
- EI manuals week 3
38+
- EI manuals week 4
39+
- EI manuals week 6
40+
- EI manuals week 7
41+
- EI manuals week 8
42+
- EI manuals week 9
43+
- warning.js
44+
- convert_mp4_to_avif.sh
45+
- EI_octal1.md
46+
- EI_octal2.md
47+
- EI_octal3.md
48+
- EI_octal4.md
49+
- electronic-instrumentation
50+
51+
## God Nodes (most connected - your core abstractions)
52+
1. `Standard admonition types` - 12 edges
53+
2. `[EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)` - 9 edges
54+
3. `Writing and style guidelines` - 8 edges
55+
4. `Folder responsibilities` - 7 edges
56+
5. `Custom admonitions used in this book` - 7 edges
57+
6. `Default manual structure` - 6 edges
58+
7. `How to use the EI manuals` - 6 edges
59+
8. `Title, Goal, Structure` - 6 edges
60+
9. `Styleguide (per experiment)` - 5 edges
61+
10. `EstimatedTimeAdmonition` - 4 edges
62+
63+
## Surprising Connections (you probably didn't know these)
64+
- None detected - all connections are within the same source files.
65+
66+
## Import Cycles
67+
- None detected.
68+
69+
## Communities (32 total, 7 thin omitted)
70+
71+
### Community 0 - "How to use the EI manuals"
72+
Cohesion: 0.11
73+
Nodes (17): Accessibility code, Anticipate, Background, Compare & Conclude, Example 1A: Digital multimeter + voltage divider, Fonts, How to use the EI manuals, Images (+9 more)
74+
75+
### Community 1 - "[EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)"
76+
Cohesion: 0.13
77+
Nodes (14): Adding or revising a manual, `book/`, `book/images/`, `book/manuals/intros/`, `book/manuals/weekX/`, `book/static/`, Build and development, [EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/) (+6 more)
78+
79+
### Community 2 - "Standard admonition types"
80+
Cohesion: 0.17
81+
Nodes (12): Attention, Caution, Danger, Error, Generic admonition (custom title), Hint, Important, Note (+4 more)
82+
83+
### Community 3 - "Repository instructions for AI agents"
84+
Cohesion: 0.22
85+
Nodes (6): Other writing conventions, Punctuation: no em or en dashes, Quick self-check before saving, Replacements for common dash idioms, Repository instructions for AI agents, Scope
86+
87+
### Community 4 - "Custom admonitions used in this book"
88+
Cohesion: 0.22
89+
Nodes (8): Admonitions, Answer (note), Custom admonitions used in this book, Deep dive (optional enrichment), Estimated time, How to use this book (note + dropdown), Interactive page, Solution to this exercise (dropdown)
90+
91+
### Community 5 - "Default manual structure"
92+
Cohesion: 0.22
93+
Nodes (8): Anticipate, Background, Compare & Conclude, Default manual structure, Expected of you, Implement & Investigate, Simulate, Welcome to the Online Manuals of the NB2420 practicum
94+
95+
### Community 6 - "Credits and License"
96+
Cohesion: 0.25
97+
Nodes (7): About the Editors, Acknowledgements, Credits and License, External resources, How the book is made, License, Publications
98+
99+
### Community 7 - "Writing and style guidelines"
100+
Cohesion: 0.25
101+
Nodes (8): 1. Organise each manual around the learning workflow, 2. Write task instructions clearly and directly, 3. Match the tone of manuals, 4. Use consistent notebook structure, 5. Be explicit about collaboration, 6. Prefer explanation over cross-referencing, 7. Keep formatting and terminology consistent, Writing and style guidelines
102+
103+
### Community 8 - "EstimatedTimeAdmonition"
104+
Cohesion: 0.50
105+
Nodes (3): EstimatedTimeAdmonition, Allow empty generic admonitions when explicitly marked as contentless., setup()
106+
107+
### Community 9 - "EI manuals week 1"
108+
Cohesion: 0.50
109+
Nodes (3): EI manuals week 1, This week's goal:, Topic of experiments
110+
111+
### Community 10 - "EI manuals week 11"
112+
Cohesion: 0.50
113+
Nodes (3): EI manuals week 11, This week's goal:, Topic of experiments
114+
115+
### Community 11 - "EI manuals week 12"
116+
Cohesion: 0.50
117+
Nodes (3): EI manuals week 12, This week's goal:, Topic of experiments
118+
119+
### Community 12 - "EI manuals week 13"
120+
Cohesion: 0.50
121+
Nodes (3): EI manuals week 13, This week's goal:, Topic of experiments
122+
123+
### Community 13 - "EI manuals week 14"
124+
Cohesion: 0.50
125+
Nodes (3): EI manuals week 14, This week's goal:, Topic of experiments
126+
127+
### Community 14 - "EI manuals week 16"
128+
Cohesion: 0.50
129+
Nodes (3): EI manuals week 16, This week's goal:, Topic of experiments
130+
131+
### Community 15 - "EI manuals week 17"
132+
Cohesion: 0.50
133+
Nodes (3): Each week's goal:, EI manuals week 17, Topic of experiments
134+
135+
### Community 16 - "EI manuals week 18"
136+
Cohesion: 0.50
137+
Nodes (3): Each week's goal:, EI manuals week 18, Topic of experiments
138+
139+
### Community 17 - "EI manuals week 19"
140+
Cohesion: 0.50
141+
Nodes (3): Each week's goal:, EI manuals week 19, Topic of experiments
142+
143+
### Community 18 - "EI manuals week 2"
144+
Cohesion: 0.50
145+
Nodes (3): EI manuals week 2, This week's goal:, Topic of experiments
146+
147+
### Community 19 - "EI manuals week 3"
148+
Cohesion: 0.50
149+
Nodes (3): EI manuals week 3, This week's goal:, Topic of experiments
150+
151+
### Community 20 - "EI manuals week 4"
152+
Cohesion: 0.50
153+
Nodes (3): EI manuals week 4, This week's goal:, Topic of experiments
154+
155+
### Community 21 - "EI manuals week 6"
156+
Cohesion: 0.50
157+
Nodes (3): EI manuals week 6, This week's goal:, Topic of experiments
158+
159+
### Community 22 - "EI manuals week 7"
160+
Cohesion: 0.50
161+
Nodes (3): EI manuals week 7, This week's goal:, Topic of experiments
162+
163+
### Community 23 - "EI manuals week 8"
164+
Cohesion: 0.50
165+
Nodes (3): EI manuals week 8, This week's goal:, Topic of experiments
166+
167+
### Community 24 - "EI manuals week 9"
168+
Cohesion: 0.50
169+
Nodes (3): EI manuals week 9, This week's goal:, Topic of experiments
170+
171+
## Knowledge Gaps
172+
- **102 isolated node(s):** `convert_mp4_to_avif.sh script`, `electronic-instrumentation`, `Replacements for common dash idioms`, `Quick self-check before saving`, `Other writing conventions` (+97 more)
173+
These have ≤1 connection - possible missing edges or undocumented components.
174+
- **7 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
175+
176+
## Suggested Questions
177+
_Questions this graph is uniquely positioned to answer:_
178+
179+
- **Why does `[EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)` connect `[EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)` to `Writing and style guidelines`?**
180+
_High betweenness centrality (0.013) - this node is a cross-community bridge._
181+
- **Why does `Standard admonition types` connect `Standard admonition types` to `Custom admonitions used in this book`?**
182+
_High betweenness centrality (0.011) - this node is a cross-community bridge._
183+
- **Why does `Writing and style guidelines` connect `Writing and style guidelines` to `[EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)`?**
184+
_High betweenness centrality (0.009) - this node is a cross-community bridge._
185+
- **What connects `convert_mp4_to_avif.sh script`, `electronic-instrumentation`, `Replacements for common dash idioms` to the rest of the system?**
186+
_102 weakly-connected nodes found - possible documentation gaps or missing edges._
187+
- **Should `How to use the EI manuals` be split into smaller, more focused modules?**
188+
_Cohesion score 0.1111111111111111 - nodes in this community are weakly interconnected._
189+
- **Should `[EI Manuals](https://nb-tudelft.github.io/Electronic_Instrumentation/development_Q2_2026/)` be split into smaller, more focused modules?**
190+
_Cohesion score 0.13333333333333333 - nodes in this community are weakly interconnected._

‎graphify-out/cache/ast/v0.9.25/0a5fe683cee19b0983f08a7081c185db752f27f12375b60d30f9a04b49e2796d.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"nodes": [{"id": "pkg_electronic_instrumentation", "label": "electronic-instrumentation", "file_type": "code", "type": "package", "ecosystem": "python", "source_file": "pyproject.toml", "source_location": "L1", "version": "1.0.0"}], "edges": [{"source": "pkg_electronic_instrumentation", "target": "pkg_download_link_replacer", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_jupyterbook_patches", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_sphinx_accessibility", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_sphinx_exercise", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_sphinx_iframes", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_sphinx_image_inverter", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_sphinx_thebe", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_teachbooks", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_teachbooks_sphinx_tippy", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_sphinx_dropdown_toggle", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_jupyter_book_duplicate_toc_entry", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_watchdog", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_numpy", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_matplotlib", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}, {"source": "pkg_electronic_instrumentation", "target": "pkg_plotly", "relation": "depends_on", "context": "dependency", "confidence": "EXTRACTED", "confidence_score": 1.0, "source_file": "pyproject.toml", "source_location": "L1", "weight": 1.0}]}

‎graphify-out/cache/ast/v0.9.25/0bd067c5d54bd36e2c4e577416630964a09c8e9eb99cfe4255a2eb1bfc7ba1c4.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"nodes": [{"id": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_md", "label": "EI_manual_week12.md", "file_type": "document", "source_file": "old/EI_manual_week12.md", "source_location": "L1"}, {"id": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_ei_manuals_week_12", "label": "EI manuals week 12", "file_type": "document", "source_file": "old/EI_manual_week12.md", "source_location": "L1"}, {"id": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_this_week_s_goal", "label": "This week's goal:", "file_type": "document", "source_file": "old/EI_manual_week12.md", "source_location": "L3"}, {"id": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_topic_of_experiments", "label": "Topic of experiments", "file_type": "document", "source_file": "old/EI_manual_week12.md", "source_location": "L6"}], "edges": [{"source": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_md", "target": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_ei_manuals_week_12", "relation": "contains", "confidence": "EXTRACTED", "source_file": "old/EI_manual_week12.md", "source_location": "L1", "weight": 1.0}, {"source": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_ei_manuals_week_12", "target": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_this_week_s_goal", "relation": "contains", "confidence": "EXTRACTED", "source_file": "old/EI_manual_week12.md", "source_location": "L3", "weight": 1.0}, {"source": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_ei_manuals_week_12", "target": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week12_topic_of_experiments", "relation": "contains", "confidence": "EXTRACTED", "source_file": "old/EI_manual_week12.md", "source_location": "L6", "weight": 1.0}], "input_tokens": 0, "output_tokens": 0}

‎graphify-out/cache/ast/v0.9.25/0f7bbaf1a43fc30518e81866e848cf54e7711b88ed8c27c4565261e2340b6c22.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"nodes": [{"id": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_md", "label": "EI_manual_week8.md", "file_type": "document", "source_file": "old/EI_manual_week8.md", "source_location": "L1"}, {"id": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_ei_manuals_week_8", "label": "EI manuals week 8", "file_type": "document", "source_file": "old/EI_manual_week8.md", "source_location": "L1"}, {"id": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_this_week_s_goal", "label": "This week's goal:", "file_type": "document", "source_file": "old/EI_manual_week8.md", "source_location": "L3"}, {"id": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_topic_of_experiments", "label": "Topic of experiments", "file_type": "document", "source_file": "old/EI_manual_week8.md", "source_location": "L6"}], "edges": [{"source": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_md", "target": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_ei_manuals_week_8", "relation": "contains", "confidence": "EXTRACTED", "source_file": "old/EI_manual_week8.md", "source_location": "L1", "weight": 1.0}, {"source": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_ei_manuals_week_8", "target": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_this_week_s_goal", "relation": "contains", "confidence": "EXTRACTED", "source_file": "old/EI_manual_week8.md", "source_location": "L3", "weight": 1.0}, {"source": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_ei_manuals_week_8", "target": "home_zam_desktop_electronic_instrumentation_manuals_old_ei_manual_week8_topic_of_experiments", "relation": "contains", "confidence": "EXTRACTED", "source_file": "old/EI_manual_week8.md", "source_location": "L6", "weight": 1.0}], "input_tokens": 0, "output_tokens": 0}

0 commit comments

Comments
 (0)