diff --git a/book/_config.yml b/book/_config.yml index e9e3763..4e3ec28 100644 --- a/book/_config.yml +++ b/book/_config.yml @@ -1,46 +1,46 @@ -title: TU Delft OIT GitHub Template #Replace this with your own book title +title: TU Delft OIT GitHub Template # Replace this with your own book title author: Author from Delft University of Technology, built with TeachBooks and Jupyter Book, CC BY 4.0 #add your own name here - + # Replace TeachBooks Teams with your own name in the line above execute: - execute_notebooks: "off" #replace this if you want don't have notebooks with output and you want to add notebook output during build + execute_notebooks: "off" # Replace this if you want don't have notebooks with output and you want to add notebook output during build -only_build_toc_files: true #replace this with false if you want to build all files in the book, allowing you to refer to pages which are not included in the table of contents +only_build_toc_files: true # Replace this with false if you want to build all files in the book, allowing you to refer to pages which are not included in the table of contents -sphinx: +sphinx: # Options passed on to the underlying sphinx-parser config: html_js_files: - - https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js #required for live code: https://teachbooks.io/manual/features/live_code.html + - https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js # Required for live code: https://teachbooks.io/manual/features/live_code.html thebe_config: - use_thebe_lite: true #required for live code: https://teachbooks.io/manual/features/live_code.html + use_thebe_lite: true # Required for live code: https://teachbooks.io/manual/features/live_code.html exclude_patterns: ["**/_*.yml", "**/*.md", "**/*.ipynb"] #exclude files which should not be accessible for live code: https://teachbooks.io/manual/features/live_code.html html_theme_options: logo: - text: TU Delft GitHub OIT Template #Replace this with your own book title - repository_url: "https://github.com/TUDelft-books/repo" #add your own repo URL here - path_to_docs: "book" #required for edit_page_button, should be book if you're using TeachBooks package (https://github.com/TeachBooks/TeachBooks) or the TeachBooks deploy book workflow (https://teachbooks.io/manual/external/deploy-book-workflow/README.html) - repository_branch: "main" #replace when you change the name of your published branch (required for edit_page_button) - use_edit_page_button: true #replace with false if you don't want the edit page button (i.e. if you don't user to propose changes themselves or have a private repo) - use_repository_button: true #replace with false if you don't want the repository button (i.e. if you have a private repo) - use_issues_button : true #replace with false if you don't want the issues button (i.e. if you don't want to use GitHub issues or have a private repo) + text: TU Delft GitHub OIT Template # Replace this with your own book title + repository_url: "https://github.com/TUDelft-books/repo" # Add your own repo URL here + path_to_docs: "book" # Required for edit_page_button, should be book if you're using TeachBooks package (https://github.com/TeachBooks/TeachBooks) or the TeachBooks deploy book workflow (https://teachbooks.io/manual/external/deploy-book-workflow/README.html) + repository_branch: "main" # Replace when you change the name of your published branch (required for edit_page_button) + use_edit_page_button: true # Replace with false if you don't want the edit page button (i.e. if you don't user to propose changes themselves or have a private repo) + use_repository_button: true # Replace with false if you don't want the repository button (i.e. if you have a private repo) + use_issues_button : true # Replace with false if you don't want the issues button (i.e. if you don't want to use GitHub issues or have a private repo) launch_buttons: - thebe: true #required for live code: https://teachbooks.io/manual/features/live_code.html - baseurl : "https://oit.tudelft.nl/" #Replace this with your own URL - html_show_copyright: false #as the copyright is included in the author field - html_last_updated_fmt: '%B %-d, %Y' #adds the date of the last update to the footer - html_static_path: ["figures"] # add folders that contain files that need to be included, such as the location of the logo(s) + thebe: true # Required for live code: https://teachbooks.io/manual/features/live_code.html + favicon : "figures/TB_favicon.ico" # Replace this with your own favicon + baseurl : "https://oit.tudelft.nl/" # Replace this with your own URL + html_show_copyright: false # As the copyright is included in the author field + html_last_updated_fmt: '%B %-d, %Y' # Adds the date of the last update to the footer + html_static_path: ["figures"] # Add folder that contain files that need to be included, such as the location of the logo(s) mathjax3_config: chtml: { - mtextInheritFont: true # To typeset text within math prettier + mtextInheritFont: true # To typeset text within math prettier } - extra_extensions: #Gives you a starter package of extensions to use in your book - - jupyterbook_patches # Patches by TeachBooks https://github.com/TeachBooks/JupyterBook-Patches - - download_link_replacer # Allows you to replace and add downloadable files to a page header https://teachbooks.io/manual/external/Download-Link-Replacer/README.html - - sphinx_image_inverter # Inverts images for dark mode https://teachbooks.io/manual/external/Sphinx-Image-Inverter/README.html - - sphinx_iframes # Eases the embedding of iframes https://teachbooks.io/manual/external/sphinx-iframes/README.html - - sphinx_exercise # Allows you to add exercise boxes to your book https://ebp-sphinx-exercise.readthedocs.io/en/latest/ - - teachbooks_sphinx_tippy # Enables hoover over tips https://teachbooks.io/manual/external/teachbooks-sphinx-tippy/README.html - - sphinx_named_colors # Allows you to use custom colors in your book https://teachbooks.io/manual/external/Sphinx-Named-Colors/README.html - - sphinx_tudelft_theme # Adds the TU Delft theme to your book https://teachbooks.io/manual/external/Sphinx-TUDelft-theme/README.html - + extra_extensions: # Gives you a starter package of extensions to use in your book + - jupyterbook_patches # Patches by TeachBooks https://github.com/TeachBooks/JupyterBook-Patches + - download_link_replacer # Allows you to replace and add downloadable files to a page header https://teachbooks.io/manual/external/Download-Link-Replacer/README.html + - sphinx_image_inverter # Inverts images for dark mode https://teachbooks.io/manual/external/Sphinx-Image-Inverter/README.html + - sphinx_iframes # Eases the embedding of iframes https://teachbooks.io/manual/external/sphinx-iframes/README.html + - sphinx_exercise # Allows you to add exercise boxes to your book https://ebp-sphinx-exercise.readthedocs.io/en/latest/ + - teachbooks_sphinx_tippy # Enables hoover over tips https://teachbooks.io/manual/external/teachbooks-sphinx-tippy/README.html + - sphinx_named_colors # Allows you to use custom colors in your book https://teachbooks.io/manual/external/Sphinx-Named-Colors/README.html + - sphinx_tudelft_theme # Adds the TU Delft theme to your book https://teachbooks.io/manual/external/Sphinx-TUDelft-theme/README.html bibtex_bibfiles: - - references.bib #required for references + - references.bib # Required for references