intro comments and filename formatting

rlanzafame · rlanzafame · commit a044ce6ad0fb · 2025-01-11T04:35:51.000+01:00
diff --git a/book/Intro_in_ToC.md b/book/Intro_in_ToC.md
@@ -1,4 +1,6 @@
 # Python for Engineers
 
+% The content of this page is defined in a separate file in order to have it appear in the home page of the book (not listed in ToC), as well as to have it listed directly in the ToC in the Introduction Part
+
 ```{include} ./intro_text.md
 ```
diff --git a/book/_toc.yml b/book/_toc.yml
@@ -6,7 +6,7 @@ root: intro
 parts:
   - caption: Introduction
     chapters:
-    - file: Intro_in_ToC.md
+    - file: intro_in_toc.md
       title: Course Overview
     - file: Python_intro.md
       title: Programming and Python
diff --git a/book/intro.md b/book/intro.md
@@ -1,4 +1,6 @@
 # Python for Engineers
 
+% The content of this page is defined in a separate file in order to have it appear in the home page of the book (not listed in ToC), as well as to have it listed directly in the ToC in the Introduction Part
+
 ```{include} ./intro_text.md
-```
+```
diff --git a/book/intro_text.md b/book/intro_text.md
@@ -1,3 +1,5 @@
+% The content of this page is included in two places: the home page of the book intro.md (not listed in ToC), as well as in the Introduction Part of the book Intro_in_ToC.md (listed in ToC)
+
 Welcome to **Python for Engineers**. We're excited to have you join us in this self-paced online course, which is designed to improve your Python skills as well as your understanding of computer programming---especially for applications in engineering and the applied geosciences. Believe it or not, as long as you are using a modern internet browser, you can take complete this course without installing a single piece of extra software!
 <!-- Join us to automate tasks, analyze data, visualize information, and develop efficient algorithms. Embrace this opportunity to expand your horizons and unlock new possibilities in your academic and professional journey.  -->
 

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+% The content of this page is included in two places: the home page of the book intro.md (not listed in ToC), as well as in the Introduction Part of the book Intro_in_ToC.md (listed in ToC)`
	`2`	`+`
`1`	`3`	`Welcome to Python for Engineers. We're excited to have you join us in this self-paced online course, which is designed to improve your Python skills as well as your understanding of computer programming---especially for applications in engineering and the applied geosciences. Believe it or not, as long as you are using a modern internet browser, you can take complete this course without installing a single piece of extra software!`
`2`	`4`	`<!-- Join us to automate tasks, analyze data, visualize information, and develop efficient algorithms. Embrace this opportunity to expand your horizons and unlock new possibilities in your academic and professional journey. -->`
`3`	`5`