Merge branch 'replace-gitlab-dependency-timon-script' into credits_references_overview_page

book/_toc.yml

@@ -109,6 +109,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

book/credits.md

@@ -33,7 +33,7 @@ Parts of this book are taken from other external resources. If an author is not
 
 The following pages are not edited by the TeachBooks Team:
 
-- [](external/latex-to-markdown-conversion/README.md) by {cite:t}`timon_latex`, [BSD 3-clause license](https://opensource.org/license/BSD-3-Clause).
+- _Work in progress: list the numerous README pages and include their respective licenses with the source code of this manual._
 
 The following pages contain content written by others, part of which may be reused and/or modified by the TeachBooks Team:
 - Page {ref}`copyright_licenses` includes an unmodified figure, paraphrased and quoted text (including hyperlinks) from {cite:ts}`hall21`.

book/helper_code/converter.md

@@ -0,0 +1,10 @@
+(tex_md_converter)=
+# Convert LaTeX to Markdown
+
+A script is to convert LaTeX files to Markdown for use in Jupyter Books {cite:p}`timon_latex`.
+
+This script 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 which is distributed under a [BSD 3-clause license](https://opensource.org/license/BSD-3-Clause), 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).

book/helper_code/intro.md

@@ -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