Part of the course “Track, organize and share your work: An introduction to Git for research”
November 29, 2024
lennartwittkuhn.com/version-control-book/chapters/branches.html
💡 Learn the basics of the Markdown syntax
💡 Work on a new quarto
branch in your city-guide
repo
💡 Create a neat new entry file using Quarto
💡 When you are done, merge the changes into your main
branch
Outlook: Your Quarto file can later be turned into a website!
You can use one of the following editors:
.qmd
file: “File” > “New file” > “Quarto Document”quarto preview
might not work in Git Bash! Use the Render
buttons in RStudio (see right column)quarto
branch in your city-guide
repository and switch to itRemember, that quarto
is just a branch name here. You can also choose a different name for the branch if you want to.
city-guide.qmd
and save it in your city-guide
repositoryQuarto and RStudio might create a bunch of extra files:
The are temporary or user specific files and should therefore not be tracked in Git.
.qmd
file to your .gitignore
file..gitignore
file.Input | Output |
---|---|
|
italics and bold |
|
superscript2 / subscript2 |
|
|
|
verbatim code |
Input | Output |
---|---|
|
Header 1 |
|
Header 2 |
|
Header 3 |
|
Header 4 |
|
Header 5 |
|
Header 6 |
Input | Output |
---|---|
|
|
|
|
|
|
Input | Output | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
💡 Tip: Use a Markdown table generator
Markdown Syntax | Output |
---|---|
|
E=mc2 |
|
E=mc2 |
Input | Output |
---|---|
|
|
Input | Output |
---|---|
|
https://quarto.org/ |
|
Quarto |
|
|
|
city-guide.qmd
fileThe YAML header of these slides:
When you are done and your Quarto file is rendering properly:
quarto
branch into your default branch (main
or master
)```{r} code ```
@sec-citations
)Type | Label Prefix |
---|---|
Figures | fig- |
Tables | tbl- |
Equations | eq- |
Sections | sec- |
Code listing | lst- |
Theorem | thm- |
@
Markdown Format | Output (author-date format) |
---|---|
|
Blip blop bloop [see Chacon and Straub (2014), pp. 33-35; also , chap. 1] |
|
Blip blop bloop (Chacon and Straub 2014, 33–35, 38–39 and passim) |
|
Blip blop bloop (Chacon and Straub 2014). |
|
Lennart says blah (2014) |
|
Chacon and Straub (2014) says bloop. |
.qmd
files.qmd
files are plain text, ensuring compatibility with git diff
.qmd
files(the company formerly known as RStudio)
Introduction to Quarto