You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content_development/Task_1.md
+47-33Lines changed: 47 additions & 33 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,19 +14,19 @@ Don't forget you can join in the discussions over at our open [**Slack channel**
14
14
15
15
## Table of contents
16
16
17
-
*[Getting started](#Getting_started)
18
-
*[Learning how to use markdown](#markdown)
17
+
*[Getting started up](#Getting_started)
18
+
*[Learning the basics of markdown syntax](#markdown)
19
19
*[](#)
20
20
*[BONUS STEP](#bonus)
21
21
22
22
23
-
## Getting started <aname="Getting_started"></a>
23
+
## Getting started up <aname="Getting_started"></a>
24
24
25
25
Welcome to your first task, probably, of the Open Science MOOC! What we *don't* want here is to create something were you sit in front of a screen, basically being lectured like you do at high school or university. We want you to create, to learn, to build, both as an individual and as part of a boundless community. We want to help you to sculpt your own path in research, and tell your own story and use that story to inspire and guide others.
26
26
27
27
In order to help this, we are going to try something that hasn't really been done before in this space. This [MOOC](https://opensciencemooc.eu/) is entirely built on a dynamic 'open source' process, with everything in the open and available to contribution from everyone. We would like you to be part of that.
28
28
29
-
Duing the tasks throughout the MOOC modules, we will help you, as a community, to directly create and edit content that becomes part of the overall course and its companion website. What you do from here on out will help to influence the learning of all individuals who come here in the future. Our job is to guide you in this process, and help you to realise that what you are doing is valuable, to yourself and others.
29
+
During the tasks throughout the MOOC modules, we will help you, as a community, to directly create and edit content that becomes part of the overall course and its companion website. What you do from here on out will help to influence the learning of all individuals who come here in the future. Our job is to guide you in this process, and help you to realise that what you are doing is valuable, to yourself and others.
30
30
31
31
**IMPOSTER SYNDROME KLAXON**
32
32
@@ -38,21 +38,24 @@ We want to remind you at the beginning that if you find any part of this MOOC co
38
38
39
39
<br/>
40
40
41
-
## Learning how to use markdown <aname="markdown"></a>
41
+
## Learning the basics of markdown syntax <aname="markdown"></a>
42
42
43
-
A lot of people think [RStudio](https://www.rstudio.com/) (covered more in [Module 5](https://github.com/OpenScienceMOOC/Module-5-Open-Research-Software-and-Open-Source/blob/master/content_development/MAIN.md)) is just for writing complex scripts for statistical analysis. Wrooooong. It can also be used to write nicely formatted text documents, using something called [markdown](https://en.wikipedia.org/wiki/Markdown). Much of this MOOC was written in markdown, and then converted from that into PDF, HTML, and Jupyter notebook formats, and look how nice it all looks!
43
+
A lot of people think [RStudio](https://www.rstudio.com/) (covered more in [Module 5](https://github.com/OpenScienceMOOC/Module-5-Open-Research-Software-and-Open-Source/blob/master/content_development/MAIN.md)) is just for writing complex scripts for statistical analysis. Wrooooong. It can also be used to write nicely formatted text documents, using something called [markdown](https://en.wikipedia.org/wiki/Markdown). Much of this MOOC was written in markdown in RStudio, and then converted from that into PDF, HTML, and Jupyter notebook formats, and look how nice it all looks!
44
44
45
45
Markdown is really a plain writing style that gives you full control over the format of text. If you're used to using something like Microsoft Word, it's kind of similar and gives you the same control over simple things like header style and text format. But in a way that is readable by more software, and can also be easily easily rendered as a webpage and many other useful output formats.
46
46
47
47
It is because markdown is so flexible in reading, writing, and conversion, that we are going to be learning a bit about it to get things started here. A collection of all things markdown-related can also be found [here](https://github.com/mundimark/awesome-markdown) for the adventurous types.
48
48
49
-
Here is some basic markdown syntax that you might find handy for now (based largely on this [cheatsheet from Adam Pritchard](https://github.com/adam-p/markdown-here/wiki/Markdown-Here-Cheatsheet)):
49
+
Here is just some of the basic markdown syntax that you might find handy for now (based largely on this [cheatsheet from Adam Pritchard](https://github.com/adam-p/markdown-here/wiki/Markdown-Here-Cheatsheet)):
50
50
51
51
```markdown
52
52
53
53
# Header one
54
+
54
55
## Header two
56
+
55
57
### Header three
58
+
56
59
#### Header four
57
60
58
61
Header with an underline
@@ -70,20 +73,14 @@ Here is some basic markdown syntax that you might find handy for now (based larg
70
73
* Just use asterisks (*)
71
74
* Like this
72
75
73
-
1. Unordered
74
-
2. And ordered
75
-
* Lists can also be
76
-
* Combined
77
-
3. Like this
78
-
* Using tabs
79
-
* To set the different
80
-
* List levels
81
-
82
76
```
83
-
77
+
84
78
# Header one
79
+
85
80
## Header two
81
+
86
82
### Header three
83
+
87
84
#### Header four
88
85
89
86
Header with an underline
@@ -98,26 +95,15 @@ Here is some basic markdown syntax that you might find handy for now (based larg
98
95
3. Like this
99
96
100
97
* For an unordered list
101
-
* Just use asterisks (*)
98
+
* Just use asterisks
102
99
* Like this
103
100
104
-
1. Unordered
105
-
2. And ordered
106
-
* Lists can also be
107
-
* Combined
108
-
3. Like this
109
-
* Using spaces
110
-
* To set the different
111
-
* List levels
112
-
113
101
For automatic links use [square brackets](https://www.google.com) and then insert the target URL in normal brackets after.
114
102
115
103
`[square brackets](https://www.google.com)`
116
104
117
105
For images, use an exclamation to indicate this and then a link to the image location:
Some times, you might want to add in little snippets of code, like we have done above. For this, use simple back ticks:
118
+
<p align="center"><i>The Open Science MOOC logo!</i></p>
119
+
```
120
+
Some times, you might want to add in little snippets of code, like we have done above. For this, use simple back ticks, these little things: `
134
121
135
122
`some code with back-ticks around it`
136
123
@@ -141,6 +128,33 @@ s = "Python syntax highlighting"
141
128
print s
142
129
```
143
130
131
+
Another handy point for highlighting text is to use block quotes, especially if you want to add a direct quote from someone (like we did for Jacquelyn above). For this, just use a right line break: >
132
+
133
+
`> This is a quote (Person, 2018)`
134
+
135
+
> This is a quote (Person, 2018)
136
+
137
+
For simplicity, line breaks are best added using the simple html code: `<br/>` as this helps to keep it much more visible where they are or need adding.
138
+
139
+
One of the last little things we might want to do is add tables, as these can look quite nifty in markdown. Let's sketch out a simple one here and see what it looks like.
140
+
141
+
```markdown
142
+
143
+
| Column 1 | Column 2 | Column 3 |
144
+
| -------------|:-------------:| ---------:|
145
+
| Tyrannosaurus| Meat | Angry |
146
+
| Velociraptor | Meat | Relaxed |
147
+
| Triceratops | Veggiesaurus | Hungry |
148
+
149
+
```
150
+
Notice how the colons are used to align the text in the columns to either the centre or right hand side?
0 commit comments