Skip to content

Commit

Permalink
Render bookdown
Browse files Browse the repository at this point in the history
  • Loading branch information
github-actions[bot] committed Jun 21, 2024
1 parent 49c6799 commit fa3ebdb
Show file tree
Hide file tree
Showing 31 changed files with 553 additions and 534 deletions.
6 changes: 3 additions & 3 deletions docs/01-intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,20 +14,20 @@ Overleaf is a very useful tool for collaborative scientific writing. It has an a
The course is intended for scientific writers who might be interested in learning how to automate some of their writing formatting/layouts.


<img src="resources/images/01-intro_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1bb9ca840c8_0_164.png" title="for indiviudals who: Are unfamiliar with what LaTeX is, but like the idea of more customizable and reproducible formatting of text in documents. Have heard of LaTeX but don’t know how to use it in practice. Want guidance on collaborating with Overleaf." alt="for indiviudals who: Are unfamiliar with what LaTeX is, but like the idea of more customizable and reproducible formatting of text in documents. Have heard of LaTeX but don’t know how to use it in practice. Want guidance on collaborating with Overleaf." width="100%" style="display: block; margin: auto;" />
<img src="resources/images/01-intro_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1bb9ca840c8_0_164.png" alt="for indiviudals who: Are unfamiliar with what LaTeX is, but like the idea of more customizable and reproducible formatting of text in documents. Have heard of LaTeX but don’t know how to use it in practice. Want guidance on collaborating with Overleaf." width="100%" style="display: block; margin: auto;" />


## Curriculum

The course covers basic information about why LaTeX can be useful, how to get started in Overleaf using LaTeX with a template, how to work with a team on Overleaf, and what to do when you encounter problems.

<img src="resources/images/01-intro_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1bb9ca840c8_0_179.png" title="Concepts covered in this course are: 1. What typsetting is, 2. What LaTeX is and how it came to be, 3. How Overleaf makes writing LaTeX documents easier, 4. How to work with a template for a scientific article intended for arXiv, 5. How to collaborate on Overleaf, 6. How to get help if you run into issues" alt="Concepts covered in this course are: 1. What typsetting is, 2. What LaTeX is and how it came to be, 3. How Overleaf makes writing LaTeX documents easier, 4. How to work with a template for a scientific article intended for arXiv, 5. How to collaborate on Overleaf, 6. How to get help if you run into issues" width="100%" style="display: block; margin: auto;" />
<img src="resources/images/01-intro_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1bb9ca840c8_0_179.png" alt="Concepts covered in this course are: 1. What typsetting is, 2. What LaTeX is and how it came to be, 3. How Overleaf makes writing LaTeX documents easier, 4. How to work with a template for a scientific article intended for arXiv, 5. How to collaborate on Overleaf, 6. How to get help if you run into issues" width="100%" style="display: block; margin: auto;" />



## Objectives

<img src="resources/images/01-intro_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1bb9ca840c8_0_196.png" title="This course will demonstrate how to: 1.Be familiar with what LaTeX is and understand the origins of how it came to be, 2. Understand the benefits of using LaTeX and Overleaf, 3. Get started writing in Overleaf with a template for a scientific manuscript, 4. Add references to a document in Overleaf, 5. Get help if you encounter challenges, 6. Work collaboratively on Overleaf" alt="This course will demonstrate how to: 1.Be familiar with what LaTeX is and understand the origins of how it came to be, 2. Understand the benefits of using LaTeX and Overleaf, 3. Get started writing in Overleaf with a template for a scientific manuscript, 4. Add references to a document in Overleaf, 5. Get help if you encounter challenges, 6. Work collaboratively on Overleaf" width="100%" style="display: block; margin: auto;" />
<img src="resources/images/01-intro_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1bb9ca840c8_0_196.png" alt="This course will demonstrate how to: 1.Be familiar with what LaTeX is and understand the origins of how it came to be, 2. Understand the benefits of using LaTeX and Overleaf, 3. Get started writing in Overleaf with a template for a scientific manuscript, 4. Add references to a document in Overleaf, 5. Get help if you encounter challenges, 6. Work collaboratively on Overleaf" width="100%" style="display: block; margin: auto;" />



14 changes: 7 additions & 7 deletions docs/02-latex.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
You may or may not have heard people talking about [LaTeX](https://www.latex-project.org/about/) (pronounced '/ˈlɑːtɛx/' LAH-tekh or '/ˈleɪtɛx/' LAY-tekh), which is not to be confused with the the material latex (pronounced '/ˈleɪtɛks/' LAY-tekhs). In this course we will explain what LaTeX is and how it came to be.


<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_0.png" title="LaTex is not latex (the material used for protective gloves and other items)." alt="LaTex is not latex (the material used for protective gloves and other items)." width="100%" style="display: block; margin: auto;" />
<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_0.png" alt="LaTex is not latex (the material used for protective gloves and other items)." width="100%" style="display: block; margin: auto;" />

## Learning Objectives

<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1bb9ca840c8_0_360.png" title="Learning Objectives: 1. Explain what LaTeX is and how it came to be 2. Understand that writing a document involves two distinct steps 1) writing the content and 2) determining how the content should be displayed, 3. Recognize that applications like microsoft word interactively show you the formatting/arrangement of the document as you write, while markup languages embed how a file should display using specific tags within the text that are later manifested, 4.Begin to understand how markup language tags result in changes in how text is displayed" alt="Learning Objectives: 1. Explain what LaTeX is and how it came to be 2. Understand that writing a document involves two distinct steps 1) writing the content and 2) determining how the content should be displayed, 3. Recognize that applications like microsoft word interactively show you the formatting/arrangement of the document as you write, while markup languages embed how a file should display using specific tags within the text that are later manifested, 4.Begin to understand how markup language tags result in changes in how text is displayed" width="100%" style="display: block; margin: auto;" />
<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1bb9ca840c8_0_360.png" alt="Learning Objectives: 1. Explain what LaTeX is and how it came to be 2. Understand that writing a document involves two distinct steps 1) writing the content and 2) determining how the content should be displayed, 3. Recognize that applications like microsoft word interactively show you the formatting/arrangement of the document as you write, while markup languages embed how a file should display using specific tags within the text that are later manifested, 4.Begin to understand how markup language tags result in changes in how text is displayed" width="100%" style="display: block; margin: auto;" />

## Document Preparation System

Expand All @@ -20,7 +20,7 @@ Typesetting determines how text looks and where it is located in a document when
Although LaTeX has a reputation for being quite tricky, it is very powerful in enabling users to create documents with complex and customized text formatting and layouts much more easily than doing so with systems like Microsoft Word.


<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_18.png" title="LaTeX allows for fancy document typesetting (meaning formatting and text layout), where as traditional text editors like Microsoft Word requires manual formatting and layout, which often leads to typical looking documents." alt="LaTeX allows for fancy document typesetting (meaning formatting and text layout), where as traditional text editors like Microsoft Word requires manual formatting and layout, which often leads to typical looking documents." width="100%" style="display: block; margin: auto;" />
<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_18.png" alt="LaTeX allows for fancy document typesetting (meaning formatting and text layout), where as traditional text editors like Microsoft Word requires manual formatting and layout, which often leads to typical looking documents." width="100%" style="display: block; margin: auto;" />



Expand Down Expand Up @@ -53,13 +53,13 @@ Tex is named as an abbreviation for the Greek word [τέχνη (ΤΕΧΝΗ techn
Typesetting has origins in how documents used to be printed using manual stamping mechanisms, where someone would provide the contents of the text in writing by hand that would be translated to a version with the intended layout and style for printing.


<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_45.png" title="Historically making printed documents required two steps: 1. Writing the content by hand, 2. Determine the layout and font and arrangement of the text with stamps." alt="Historically making printed documents required two steps: 1. Writing the content by hand, 2. Determine the layout and font and arrangement of the text with stamps." width="100%" style="display: block; margin: auto;" />
<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_45.png" alt="Historically making printed documents required two steps: 1. Writing the content by hand, 2. Determine the layout and font and arrangement of the text with stamps." width="100%" style="display: block; margin: auto;" />


Overtime this process got replaced by digital options and eventually resulted in the concept of WYSIWYG (What you see is what you get), where programs like Microsoft Word let you interactively work with the typesetting of a document as you write the content.


<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_67.png" title="WYSIWYG - What you see is what you get - the document is displayed like the final product as you write it." alt="WYSIWYG - What you see is what you get - the document is displayed like the final product as you write it." width="100%" style="display: block; margin: auto;" />
<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_67.png" alt="WYSIWYG - What you see is what you get - the document is displayed like the final product as you write it." width="100%" style="display: block; margin: auto;" />


When you use a program like Microsoft Word, you are essentially giving it two sets of directions simultaneously, one which is the content of the text, and one which is the style and layout of the text.
Expand All @@ -81,7 +81,7 @@ In HTML we could instead use `<b>` at the beginning of the text we want to bold,
**LaTeX:**<br>
Just like in HTML, LaTeX also uses text around the actual content text to describe how to produce the final product. In this case, we would indicate that we want bold text using a tag `\textbf` with brackets around the text we want to change like so: `\textbf{bold text}`.

<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1babf2134b3_0_153.png" title="A table of the methods just described to bold text to indicate that text around the plain text is used to format the text itself within markup languages." alt="A table of the methods just described to bold text to indicate that text around the plain text is used to format the text itself within markup languages." width="100%" style="display: block; margin: auto;" />
<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1babf2134b3_0_153.png" alt="A table of the methods just described to bold text to indicate that text around the plain text is used to format the text itself within markup languages." width="100%" style="display: block; margin: auto;" />

As you can see, LaTeX will feel a bit different from writing in Microsoft Word, as we will be using text tags to define how we want the content text to look.

Expand All @@ -96,7 +96,7 @@ Now that you are a little more clear about what LaTeX is, it might be easier to
5) You can add languages with different alphabets or mathematical notation with much more ease than with traditional text editors
6) You can collaborate with people who use LaTeX more easily

<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_77.png" title="Benefits of Using LaTeX: Using a template allows you to focus on the content and not the formatting/layout, Can create very complex documents, Can reproduce style/typesetting of a document easily again, Can easily change the typesetting of an entire document, Can add languages with other alphabets or mathematical notation easily, If you know LaTeX you can collaborate with others who use it!" alt="Benefits of Using LaTeX: Using a template allows you to focus on the content and not the formatting/layout, Can create very complex documents, Can reproduce style/typesetting of a document easily again, Can easily change the typesetting of an entire document, Can add languages with other alphabets or mathematical notation easily, If you know LaTeX you can collaborate with others who use it!" width="100%" style="display: block; margin: auto;" />
<img src="02-latex_files/figure-html//1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8_g1be15cb26d3_0_77.png" alt="Benefits of Using LaTeX: Using a template allows you to focus on the content and not the formatting/layout, Can create very complex documents, Can reproduce style/typesetting of a document easily again, Can easily change the typesetting of an entire document, Can add languages with other alphabets or mathematical notation easily, If you know LaTeX you can collaborate with others who use it!" width="100%" style="display: block; margin: auto;" />

## Conclusion

Expand Down
Loading

0 comments on commit fa3ebdb

Please sign in to comment.