Conclusion
This guide has presented the features of the quarto-cnam-thesis template following the code + output principle: each syntax is shown exactly as typed, then immediately rendered in the document. This self-referential approach aims to make the template self-sufficient as documentation.
Feature summary
| Feature | Key syntax | Chapter |
|---|---|---|
| Structure | Hierarchy # / ## / ### / #### |
1 |
{.unnumbered}, {.toc-black} |
1 | |
{#sec-label} + @sec-label |
1 | |
short-title="…" |
1 | |
| Figures | {#fig-label width=X%} |
2 |
Chunk {python} with #\| label: fig-… |
2 | |
layout-ncol=2 |
2 | |
{=latex} block in :::{#fig-} div |
2 | |
| Math & tables | $…$ / $$…$$ {#eq-label} |
3 |
\begin{aligned}, \begin{cases} |
3 | |
Pipe table + : Caption. {#tbl-label} |
3 | |
[text]{rs=N}, ^, === (quartable) |
3 | |
| Callouts | {.callout-note} |
4 |
{.callout-tip} |
4 | |
{.callout-warning} |
4 | |
{.callout-important} |
4 | |
{.callout-caution} |
4 | |
| References | [@key] / [@key1; @key2] |
5 |
{{< acr >}}, {{< terme >}}, {{< acrs >}} |
5 | |
{{< comment >}}, {{< todo >}}, {{< note >}} |
5 | |
.resume-block, .abstract-block |
5 |
Recommended workflow
AstuceDaily writing cycle
- Write in HTML:
quarto render --profile en --to cnam-thesis-html --no-clean— fast rendering, easy navigation, ideal for proofreading. - Check the PDF before each csi meeting:
quarto render --profile en— compiles everything and generates the PDF/A-1b. - Version regularly: commit at least after each writing session, ideally before and after each supervision meeting.
- Disable comments before final submission:
extensions.quarto-comments.enabled: falsein_quarto.yml.
The template is maintained on GitHub. To report an issue or propose an improvement: zinc75/quarto-cnam-thesis.