Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(docs): document HTML custom templates #357

Merged
merged 3 commits into from
Jan 23, 2024
Merged

Conversation

jeertmans
Copy link
Owner

@jeertmans jeertmans commented Jan 22, 2024

Shows an example of custom template.

TODO:

  • finish documentating;
  • add possibility to pass -cargs to Manim Slides' convert method when calling the Sphinx extension.

Closes #356

Shows an example of custom template.

TODO:
- [ ] finish documentating;
- [ ] add possibility to pass `-cargs` to Manim Slides' `convert` method when calling the Sphinx extension.

Closes #356
@jeertmans jeertmans added the documentation Improvements or additions to documentation label Jan 22, 2024

### What to add

```{eval-rst}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
Two consecutive dots (DOUBLE_PUNCTUATION)
Suggestions: .,
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-periods
Rule: https://community.languagetool.org/rule/show/DOUBLE_PUNCTUATION?lang=en-US
Category: PUNCTUATION


```{eval-rst}
.. literalinclude:: ../_static/template.diff
:language: html

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
File types are normally capitalized. (FILE_EXTENSIONS_CASE[1])
Suggestions: HTML
URL: https://languagetool.org/insights/post/spelling-capital-letters/
Rule: https://community.languagetool.org/rule/show/FILE_EXTENSIONS_CASE?lang=en-US&subId=1
Category: CASING


### Full code

```{eval-rst}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
Two consecutive dots (DOUBLE_PUNCTUATION)
Suggestions: .,
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-periods
Rule: https://community.languagetool.org/rule/show/DOUBLE_PUNCTUATION?lang=en-US
Category: PUNCTUATION


```{eval-rst}
.. literalinclude:: ../_static/template.html
:language: html+jinja

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
File types are normally capitalized. (FILE_EXTENSIONS_CASE[1])
Suggestions: HTML
URL: https://languagetool.org/insights/post/spelling-capital-letters/
Rule: https://community.languagetool.org/rule/show/FILE_EXTENSIONS_CASE?lang=en-US&subId=1
Category: CASING

Copy link

codecov bot commented Jan 22, 2024

Codecov Report

Attention: 7 lines in your changes are missing coverage. Please review.

Comparison is base (02a8173) 80.60% compared to head (137a358) 80.33%.

Files Patch % Lines
manim_slides/docs/manim_slides_directive.py 0.00% 7 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main     #357      +/-   ##
==========================================
- Coverage   80.60%   80.33%   -0.27%     
==========================================
  Files          21       21              
  Lines        1789     1795       +6     
==========================================
  Hits         1442     1442              
- Misses        347      353       +6     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Then, using the `:template: <path/to/custom_template.html>`
option, the basic example renders as follows:

```{eval-rst}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
Two consecutive dots (DOUBLE_PUNCTUATION)
Suggestions: .,
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-periods
Rule: https://community.languagetool.org/rule/show/DOUBLE_PUNCTUATION?lang=en-US
Category: PUNCTUATION

@jeertmans jeertmans merged commit 7ba4772 into main Jan 23, 2024
16 of 23 checks passed
@jeertmans jeertmans deleted the example-template branch January 23, 2024 10:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[FEATURE] Add a digital clock on each slide of the html output
1 participant