admin2/manual_teachbooks
1
0
Fork 0
mirror of https://github.com/TeachBooks/manual.git synced 2026-11-12 22:35:51 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #54 from TeachBooks/replace-gitlab-dependency-timon-script

Browse source 
replace page for converter without gitlab submodule
This commit is contained in:
Tom van Woudenberg 2024-12-16 18:19:26 +01:00 • committed by GitHub
commit d941ff881e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 10 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
book/_toc.yml
View file

@ -104,6 +104,7 @@ parts:
- file: tools/figmaker
- file: helper_code/intro.md
sections:
- file: helper_code/converter.md
- file: external/Useful_python_code/snippit.ipynb
- file: external/Useful_python_code/extensionfildownloadreturn.ipynb
- file: external/Useful_python_code/figshrinker.ipynb

8
book/helper_code/converter.md Normal file
View file

@ -0,0 +1,8 @@
(tex_md_converter)=
# Convert LaTeX to Markdown
A script is to convert LaTeX files to Markdown, for use in Jupyter Books, which has been used successfully on at least one book in the TU Delft OPEN library: [Introduction to particle and continuum mechanics, by Timon Idema](https://textbooks.open.tudelft.nl/textbooks/catalog/book/81). The author is able to convert nearly everything in this book automatically, with only a few manual adjustments needed (e.g., a special character and a figure caption).
Depending on the number of custom LaTeX commands used in your book, you may need to adjust the script to handle them.
Additional information about the script, along with the source code itself, is available at the following link on TU Delft GitLab: [gitlab.tudelft.nl/opentextbooks/latex-to-markdown-conversion](https://gitlab.tudelft.nl/opentextbooks/latex-to-markdown-conversion).

1
book/helper_code/intro.md
View file

@ -1,6 +1,7 @@
# Scripts for automating workflow
This chapter contains a few scripts which can be useful in the book-editing process:
- [LaTeX to markdown conversion](tex_md_converter) to convert a LaTeX file into jupyter-book compatible markdown.
- [Snippitall](Snippitall) to insert the same code snippet at a certain point in each md file in a specific folder and all subfolder.
- [Snippitonce](Snippitonce) to insert the same code snippet at a certain point in each md file only in a specific folder.
- [Extensionchecker](Extensionchecker) to identify the kind of files present in subfolder