Skip to content

Commit 56da2f2

Browse files
Add _config.yml updates for quantecon-book-theme 0.15.1 (#156)
* ⬆️ Bump quantecon-book-theme from 0.10.0 to 0.15.1 Bumps [quantecon-book-theme](https://github.com/QuantEcon/quantecon-book-theme) from 0.10.0 to 0.15.1. - [Release notes](https://github.com/QuantEcon/quantecon-book-theme/releases) - [Changelog](https://github.com/QuantEcon/quantecon-book-theme/blob/main/CHANGELOG.md) - [Commits](QuantEcon/quantecon-book-theme@v0.10.0...v0.15.1) --- updated-dependencies: - dependency-name: quantecon-book-theme dependency-version: 0.15.1 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <[email protected]> * Update _config.yml for quantecon-book-theme 0.15.1 compatibility - Add path_to_docs: lectures (critical for notebook URL generation fix in 0.15.1) - Add authors section with structured metadata - Add parse section with myst_enable_extensions - Add html section with baseurl - Add nb_mime_priority_overrides for better rendering control - Add html_static_path configuration - Add mathjax_path for explicit CDN configuration - Add linkcheck_ignore, suppress_warnings, nb_merge_streams - Reorganize config structure to match lecture-python.myst reference * Add sphinx-proof and sphinx-exercise configuration - Add proof_minimal_theme: true for cleaner proof styling - Add exercise_style: solution_follow_exercise for better exercise layout * Fix incorrectly labelled exercise solutions in generators.md - Change solution labels from ergodicity-ex-* to generators-ex-* - The solutions were always for the generators exercises, just mislabeled - Fixes sphinx-exercise warnings about cross-document references - Solutions now correctly reference their exercises in the same document * Enable full git history for git metadata features - Add fetch-depth: 0 to checkout action - Allows quantecon-book-theme to display last modified dates and changelog - Git metadata features require full commit history to function --------- Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
1 parent 22d653e commit 56da2f2

File tree

3 files changed

+87
-20
lines changed

3 files changed

+87
-20
lines changed

.github/workflows/ci.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ jobs:
88
steps:
99
- name: Checkout
1010
uses: actions/checkout@v6
11+
with:
12+
fetch-depth: 0
1113
- name: Setup Anaconda
1214
uses: conda-incubator/setup-miniconda@v3
1315
with:

lectures/_config.yml

Lines changed: 82 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,91 @@ author: Thomas J. Sargent & John Stachurski
44
logo: _static/qe-logo-large.png
55
description: These lectures provides a short introduction to continuous time Markov chains designed and written by Thomas J. Sargent and John Stachurski.
66

7+
parse:
8+
myst_enable_extensions:
9+
- amsmath
10+
- colon_fence
11+
- deflist
12+
- dollarmath
13+
- html_admonition
14+
- html_image
15+
- linkify
16+
- replacements
17+
- smartquotes
18+
- substitution
19+
20+
only_build_toc_files: true
21+
22+
execute:
23+
execute_notebooks: cache
24+
25+
bibtex_bibfiles:
26+
- references.bib
27+
28+
html:
29+
baseurl: https://continuous-time-mcs.quantecon.org/
30+
31+
latex:
32+
latex_engine: "xelatex"
33+
latex_documents:
34+
targetname: book.tex
35+
736
sphinx:
37+
extra_extensions:
38+
- sphinx_proof
39+
- sphinx_exercise
40+
- sphinx_tojupyter
41+
842
config:
43+
# false-positive links
44+
linkcheck_ignore: []
45+
bibtex_reference_style: author_year
46+
suppress_warnings: ["mystnb.unknown_mime_type"]
47+
nb_merge_streams: true
48+
nb_mime_priority_overrides: [
49+
# HTML
50+
['html', 'application/vnd.jupyter.widget-view+json', 10],
51+
['html', 'application/javascript', 20],
52+
['html', 'text/html', 30],
53+
['html', 'text/latex', 40],
54+
['html', 'image/svg+xml', 50],
55+
['html', 'image/png', 60],
56+
['html', 'image/jpeg', 70],
57+
['html', 'text/markdown', 80],
58+
['html', 'text/plain', 90],
59+
# Jupyter Notebooks
60+
['jupyter', 'application/vnd.jupyter.widget-view+json', 10],
61+
['jupyter', 'application/javascript', 20],
62+
['jupyter', 'text/html', 30],
63+
['jupyter', 'text/latex', 40],
64+
['jupyter', 'image/svg+xml', 50],
65+
['jupyter', 'image/png', 60],
66+
['jupyter', 'image/jpeg', 70],
67+
['jupyter', 'text/markdown', 80],
68+
['jupyter', 'text/plain', 90],
69+
# LaTeX
70+
['latex', 'text/latex', 10],
71+
['latex', 'application/pdf', 20],
72+
['latex', 'image/png', 30],
73+
['latex', 'image/jpeg', 40],
74+
['latex', 'text/markdown', 50],
75+
['latex', 'text/plain', 60],
76+
# Link Checker
77+
['linkcheck', 'text/plain', 10],
78+
]
979
html_theme: quantecon_book_theme
80+
html_static_path: ['_static']
1081
html_theme_options:
82+
authors:
83+
- name: Thomas J. Sargent
84+
url: http://www.tomsargent.com/
85+
- name: John Stachurski
86+
url: https://johnstachurski.net/
1187
header_organisation_url: https://quantecon.org
1288
header_organisation: QuantEcon
1389
repository_url: https://github.com/QuantEcon/continuous_time_mcs
1490
nb_repository_url: https://github.com/QuantEcon/continuous_time_mcs.notebooks
91+
path_to_docs: lectures
1592
twitter: quantecon
1693
twitter_logo_url: https://assets.quantecon.org/img/qe-twitter-logo.png
1794
og_logo_url: https://assets.quantecon.org/img/qe-og-logo.png
@@ -21,7 +98,6 @@ sphinx:
2198
google_analytics_id: G-MVZ2FSB14W
2299
launch_buttons:
23100
colab_url: https://colab.research.google.com
24-
bibtex_reference_style: author_year
25101
mathjax3_config:
26102
tex:
27103
macros:
@@ -39,6 +115,11 @@ sphinx:
39115
"lL" : "\\mathcal{L}"
40116
"linop" : "\\mathcal{L}(\\mathbb{B})"
41117
"linopell" : "\\mathcal{L}(\\ell_1)"
118+
mathjax_path: https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
119+
# sphinx-proof
120+
proof_minimal_theme: true
121+
# sphinx-exercise
122+
exercise_style: "solution_follow_exercise"
42123
# sphinx-tojupyter
43124
tojupyter_static_file_path: ["_static"]
44125
tojupyter_target_html: true
@@ -53,19 +134,3 @@ sphinx:
53134
name: python3
54135
file_extension: ".py"
55136
tojupyter_images_markdown: true
56-
57-
extra_extensions:
58-
- sphinx_proof
59-
- sphinx_exercise
60-
- sphinx_tojupyter
61-
62-
execute:
63-
execute_notebooks: cache
64-
65-
latex:
66-
latex_engine: "xelatex"
67-
latex_documents:
68-
targetname: book.tex
69-
70-
bibtex_bibfiles:
71-
- references.bib

lectures/generators.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -432,7 +432,7 @@ example, Chapter 7 of {cite}`bobrowski2005functional`.
432432
Prove that {eq}`expdiffer` holds for all $A \in \linop$.
433433
```
434434
435-
```{solution} ergodicity-ex-1
435+
```{solution} generators-ex-1
436436
:class: dropdown
437437
438438
To show the first equality, fix $t \in \RR_+$, take $h > 0$ and observe that
@@ -475,7 +475,7 @@ Using this and {eq}`czsg2`, show that, for any $g \in \BB$, the map $t \mapsto
475475
U_t g$ is continuous at all $t$.
476476
```
477477
478-
```{solution} ergodicity-ex-2
478+
```{solution} generators-ex-2
479479
:class: dropdown
480480
481481
Let $(U_t)$ be an evolution semigroup satisfying {eq}`czsg2` and let
@@ -516,7 +516,7 @@ In particular, show that, for any $t_n \to t$, we have
516516
$\| U_{t_n} - U_t \| \to 0$ as $n \to \infty$.
517517
```
518518
519-
```{solution} ergodicity-ex-3
519+
```{solution} generators-ex-3
520520
:class: dropdown
521521
522522
The solution is similar to that of the previous exercise.

0 commit comments

Comments
 (0)