generated from jhudsl/OTTR_Template
-
Notifications
You must be signed in to change notification settings - Fork 0
/
06-troubleshooting.Rmd
111 lines (66 loc) · 6.45 KB
/
06-troubleshooting.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
# Troubleshooting
Overleaf has lots of ways to make writing in LaTeX easier. In this chapter we will cover several of these ways, as well as how to identify and fix a problem if you encounter one.
```{r, fig.align='center', out.width="100%", echo = FALSE, fig.alt= "Learning Objectives:1. Recognize how Overleaf offers extra support, 2. Identify when there is an Issue, 3.Know how to get help"}
ottrpal::include_slide("https://docs.google.com/presentation/d/1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8/edit#slide=id.g1c84a339a79_0_39")
```
## Code Suggestions
As you type code, Overleaf makes code suggestions based on what you have already typed. You can click on a suggestion to use it. Overleaf will also offer suggestions on what to put within command brackets. This can be great if you can't quite remember what a command is or if you are trying to write a document faster.
```{r, fig.align='center', out.width="100%", echo = FALSE, fig.alt= "Overleaf makes code suggestions based on what you have already typed. You can click the suggestion to autocomplete your code."}
ottrpal::include_slide("https://docs.google.com/presentation/d/1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8/edit#slide=id.g1c917691280_100_0")
```
## Symbol Palette
If you need to use many symbols or mathematical notations in your work, the symbol palette can be very helpful. You can access it by pressing the button that looks like an omega symbol at the top of the source editor.
```{r, fig.align='center', out.width="100%", echo = FALSE, fig.alt= "The symbol palette can be very helpful. It can be accessed at the top of the source editor. "}
ottrpal::include_slide("https://docs.google.com/presentation/d/1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8/edit#slide=id.g1c917691280_100_7")
```
## History
If you change something and want to see what it was like previously, you can checkout the History tab.
Here you will see the most recent changes as slices of changes overtime. Changes will be highlighted in a color that coordinates with specific users. So if you have collaborators you can see their changes here as well.
If you are using the comparison mode you will see the changes and who made them. However, you can also just look at the files from a specific point in time without seeing changes by clicking on the "view single version" button.
```{r, fig.align='center', out.width="100%", echo = FALSE, fig.alt= "The History Tab shows you changes when in comparison mode. Changes are highlighted in color."}
ottrpal::include_slide("https://docs.google.com/presentation/d/1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8/edit#slide=id.g1cc5927a0b3_0_12")
```
For more information about using the history features of Overleaf, see this [documentation](https://www.overleaf.com/learn/latex/Using_the_History_feature) @overleaf_history.
## Log
If you check the log by clicking on the button to the right of the recompile button, you will see messages about any warnings or errors.
The link button at the top of each message will take you to the line of the file that is problematic.
Hovering on the red circle right next to the line number will show you information about what might be wrong with that line.
```{r, fig.align='center', out.width="100%", echo = FALSE, fig.alt= "Log errors can take you to the line that is problematic"}
ottrpal::include_slide("https://docs.google.com/presentation/d/1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8/edit#slide=id.g1cc5927a0b3_0_17")
```
## Trouble Compiling
Occasionally, you will not be able to compile your document and will get an error.
When this happens, look for yellow triangles or red circles in your source code to determine what might have gone wrong.
Remember if you hover over them, they will give you helpful messages.
Keep in mind that sometimes an error happens earlier than where a red circle is indicated.
Here is an example of brackets that were not closed on line 76 where the yellow triangle is, but the red circle shows up on the next line because Overleaf expects you to close it here.
```{r, fig.align='center', out.width="100%", echo = FALSE, fig.alt= "An image of code with an error circle at the next line and a warning triangle at the previous line."}
ottrpal::include_slide("https://docs.google.com/presentation/d/1UgGtVn7RsqdQ4pJxDk_dueSyREHcH-uWTNAT27E2mG8/edit#slide=id.g1c917691280_100_39")
```
<div class = "warning">
Remember, it is a good idea to press the "Recompile" button frequently, so that you can identify any errors more easily. If you wait too long to check, then you will have more new changes to look through to try to understand the error.
</div>
## Getting Help
There are many useful resources if you get stuck:
* The Overleaf documentation has lots of helpful information: https://www.overleaf.com/learn
These pages are especially useful:
- [Troubleshooting errors](https://www.overleaf.com/learn/latex/Errors)
- [Learning LaTeX](https://www.overleaf.com/learn/latex/Learn_LaTeX_in_30_minutes)
- [How-to guides](https://www.overleaf.com/learn/how-to)
- [Creating tables](https://www.overleaf.com/learn/latex/Tables)
* The TeX stackexchange: https://tex.stackexchange.com/
* TeX blog: https://texblog.org/tex-resources/
* LaTeX project: https://www.latex-project.org/help/documentation/
If you are submitting a paper to arXiv these resources may also be helpful:
- https://www.overleaf.com/learn/how-to/LaTeX_checklist_for_arXiv_submissions
- https://info.arxiv.org/help/submit_tex.html
## Conclusion
We hope that this chapter has given you some guidance about how to make it easier to write your documents, identify errors, and find help.
Here are some of the major take-home messages:
1. Overleaf offers helpful code suggestions to make writing easier.
1. Overleaf has a symbol palette to help you write with symbols. This can be accessed by pressing the symbol button, which looks like an omega, at the top menu.
1. You can see changes and previous versions of a document under the history tab. This also shows you who made those changes.
1. The log can give you more information about any errors or potential issues with your document. Each message in the log has a link to take you to the potentially problematic line of code.
1. Triangles and circles in the left side of the source editor can indicate issues. If you hover over them, more information will pop up about what the problem might be.
1. Keep in mind that sometimes an error or issue is due to something earlier in the code.
1. If you run into an issue, there are lots of resources to help you!