Skip to content

Commit b21a805

Browse files
authored
Merge pull request #285 from inbo/gfm
Consistently use gfm+footnotes rather than markdown_github
2 parents 31e1dfc + c9b14c1 commit b21a805

File tree

104 files changed

+825
-736
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

104 files changed

+825
-736
lines changed

content/articles/communicating/index.Rmd

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,9 @@ bibliography: ../reproducible_research.bib
66
categories: ["literature"]
77
tags: ["literature", "open science"]
88
output:
9-
md_document:
10-
preserve_yaml: true
9+
md_document:
10+
preserve_yaml: true
11+
variant: gfm+footnotes
1112
---
1213

1314
This page lists **selected** literature and online resources. Some are related to existing tutorial pages, while others are not. They are supposed to be of high interest to this site's users.

content/articles/communicating/index.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,9 @@ bibliography: ../reproducible_research.bib
66
categories: ["literature"]
77
tags: ["literature", "open science"]
88
output:
9-
md_document:
10-
preserve_yaml: true
9+
md_document:
10+
preserve_yaml: true
11+
variant: gfm+footnotes
1112
---
1213

1314
This page lists **selected** literature and online resources. Some are
@@ -18,8 +19,7 @@ Several of the resources were added based on an inspiring
1819
[talk](https://docs.google.com/presentation/d/10KkXEv4r3wWtdKvB6RFOPe809eMNldODaRqQxn-jeME/edit?usp=sharing)
1920
by Julia Lowndes at the SAFRED conference, Brussels, 27 Feb 2018.
2021

21-
Sharing data
22-
------------
22+
## Sharing data
2323

2424
- Ellis & Leek (2017): guidelines for **providing data** to a
2525
scientist / statistician: provide raw data, format consistently,
@@ -30,14 +30,12 @@ Sharing data
3030
and considerations to be made
3131
- Perkel (2016): **data repository sites** like github and others
3232

33-
Communicating
34-
-------------
33+
## Communicating
3534

3635
- Smith *et al.* (2016): recommendations of the FORCE11 Software
3736
Citation Working Group
3837

39-
Bibliography
40-
------------
38+
## Bibliography
4139

4240
Culina A., Baglioni M., Crowther T.W., Visser M.E., Woutersen-Windhouwer
4341
S. & Manghi P. (2018). Navigating the unfolding open data landscape in

content/articles/computing/index.Rmd

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ bibliography: ../reproducible_research.bib
66
categories: ["literature"]
77
tags: ["literature", "open science"]
88
output:
9-
md_document:
10-
preserve_yaml: true
11-
variant: gfm
9+
md_document:
10+
preserve_yaml: true
11+
variant: gfm+footnotes
1212
---
1313

1414
This page lists **selected** literature and online resources. Some are related to existing tutorial pages, while others are not. They are supposed to be of high interest to this site's users.

content/articles/computing/index.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ bibliography: ../reproducible_research.bib
66
categories: ["literature"]
77
tags: ["literature", "open science"]
88
output:
9-
md_document:
10-
preserve_yaml: true
11-
variant: gfm
9+
md_document:
10+
preserve_yaml: true
11+
variant: gfm+footnotes
1212
---
1313

1414
This page lists **selected** literature and online resources. Some are
@@ -21,34 +21,34 @@ by Julia Lowndes at the SAFRED conference, Brussels, 27 Feb 2018.
2121

2222
## Overviews
2323

24-
- Wilson *et al.* (2017): set of **good computing practices** that
24+
- Wilson *et al.* (2017): set of **good computing practices** that
2525
every researcher can adopt
26-
- British Ecological Society (2014): planning the **data life cycle**;
26+
- British Ecological Society (2014): planning the **data life cycle**;
2727
creating, processing, documenting, preserving, sharing & reusing
2828
data
29-
- Goudeseune *et al.* (2019): **open data management**, data
29+
- Goudeseune *et al.* (2019): **open data management**, data
3030
management plan, repositories, standards and licenses
31-
- Cooper & Hsing (2017): file organisation, workflow documentation,
31+
- Cooper & Hsing (2017): file organisation, workflow documentation,
3232
**code** reproducibility and readability, writing reproducible
3333
reports, version control and code archiving
34-
- Marwick *et al.* (2018): the **research compendium** as a solution
34+
- Marwick *et al.* (2018): the **research compendium** as a solution
3535
to share research in a reproducible way
36-
- Ibanez *et al.* (2014): vision on reproducible science, routine
36+
- Ibanez *et al.* (2014): vision on reproducible science, routine
3737
**practices**, collaboration, literate computing
3838

3939
See also some resources related to [learning and education](../skills)
4040
and the [discipline of open and reproducible science](../open_science).
4141

4242
## Specific tools
4343

44-
- Ross *et al.* (2017): about **tidyverse** workflow and tools
45-
- <https://www.tidyverse.org>: website of the tidyverse **packages**
44+
- Ross *et al.* (2017): about **tidyverse** workflow and tools
45+
- <https://www.tidyverse.org>: website of the tidyverse **packages**
4646

4747
## Focus on version control workflows
4848

49-
- Bryan (2017): rationale, workflows and tools regarding version
49+
- Bryan (2017): rationale, workflows and tools regarding version
5050
control for project organization
51-
- Bryan *et al.* (2019): getting started with git and github workflows
51+
- Bryan *et al.* (2019): getting started with git and github workflows
5252
in RStudio
5353

5454
## Bibliography

content/articles/geospatial_standards/index.Rmd

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ bibliography: ../reproducible_research.bib
88
categories: ["r", "gis"]
99
tags: ["gis", "r", "open science"]
1010
output:
11-
md_document:
12-
preserve_yaml: true
13-
variant: gfm
11+
md_document:
12+
preserve_yaml: true
13+
variant: gfm+footnotes
1414
---
1515

1616
Some inspiration for this post came from the beautiful books of @lovelace_geocomputation_2020, @pebesma_edzer_spatial_2019 and @heijmans_spatial_2019, and from various websites.

content/articles/geospatial_standards/index.md

Lines changed: 40 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ bibliography: ../reproducible_research.bib
88
categories: ["r", "gis"]
99
tags: ["gis", "r", "open science"]
1010
output:
11-
md_document:
12-
preserve_yaml: true
13-
variant: gfm
11+
md_document:
12+
preserve_yaml: true
13+
variant: gfm+footnotes
1414
---
1515

1616
Some inspiration for this post came from the beautiful books of Lovelace
@@ -19,25 +19,25 @@ various websites.
1919

2020
## Why use open standards?
2121

22-
- Open file standards ease collaboration, portability and
22+
- Open file standards ease collaboration, portability and
2323
compatibility between users, machines and applications.
24-
- Their (file) structure is fully documented.
25-
- Consequently, scientists and programmers can build new software
24+
- Their (file) structure is fully documented.
25+
- Consequently, scientists and programmers can build new software
2626
/ packages and make innovations that use these standards, while
2727
maintaining interoperability with existing applications.
28-
- And, there is a much higher chance that your data will still be
28+
- And, there is a much higher chance that your data will still be
2929
readable in a hundred years from now. The standard’s open
3030
documentation makes it relatively easy to build tools that can
31-
read an ancient open-standard file\!
31+
read an ancient open-standard file!
3232

33-
Luckily, quite a list of open standards is available\! Below, some
33+
Luckily, quite a list of open standards is available! Below, some
3434
powerful and widely-used single-file formats are introduced. Single-file
3535
data sources are readily amenable to exchange and publication.
3636

3737
I see you can’t wait to start practicing, so you can also head straight
3838
over to the [tutorial on vector
3939
formats](../../tutorials/spatial_standards_vector/) and the [tutorial on
40-
raster formats](../../tutorials/spatial_standards_raster/)\! In these
40+
raster formats](../../tutorials/spatial_standards_raster/)! In these
4141
tutorials, a comparison table of vector/raster file formats is also
4242
presented.
4343

@@ -46,9 +46,9 @@ presented.
4646
**[GDAL](https://gdal.org)** (Geospatial Data Abstraction Library) is by
4747
far the most used collection of open-source drivers for:
4848

49-
- a lot of [raster](https://gdal.org/drivers/raster/index.html)
49+
- a lot of [raster](https://gdal.org/drivers/raster/index.html)
5050
formats;
51-
- a lot of [vector](https://gdal.org/drivers/vector/index.html)
51+
- a lot of [vector](https://gdal.org/drivers/vector/index.html)
5252
formats.
5353

5454
In other words, it is the preferred workhorse for reading and writing
@@ -62,27 +62,27 @@ So, in R we use packages that use GDAL in the background, such as
6262

6363
## The GeoPackage file format
6464

65-
- Its website is <https://www.geopackage.org>.
66-
- It is a standardized implementation of an SQLite database for
65+
- Its website is <https://www.geopackage.org>.
66+
- It is a standardized implementation of an SQLite database for
6767
geospatial data. Hence, a GeoPackage is a **binary** file
6868
(`filename.gpkg`). It shares this property with shapefiles, which
69-
however pose multiple limitations,\[1\] so the GeoPackage is a more
69+
however pose multiple limitations,[^1] so the GeoPackage is a more
7070
than suitable replacement.
71-
- The GeoPackage can store one or *multiple* **vector** layers
71+
- The GeoPackage can store one or *multiple* **vector** layers
7272
(points, lines, polygons and related feature types). Besides vector
7373
data, it can also store **raster** data or extra standalone
7474
**tables**. These properties make it somehow comparable to the
7575
‘personal geodatabase’ of ArcGIS – ESRI’s closed, Windows-only
76-
format.\[2\]
77-
- The GeoPackage standard is
76+
format.[^2]
77+
- The GeoPackage standard is
7878
[maintained](https://www.opengeospatial.org/standards/geopackage) by
7979
the [Open Geospatial Consortium](https://www.opengeospatial.org/)
8080
(OGC), which stands out as a reference when it comes to open
8181
geospatial standards.
8282

8383
## The GeoJSON file format
8484

85-
- One [GeoJSON](https://tools.ietf.org/html/rfc7946) file
85+
- One [GeoJSON](https://tools.ietf.org/html/rfc7946) file
8686
(`filename.geojson`) contains *one* **vector** layer. Note that one
8787
vector layer can combine different [feature geometry
8888
types](https://r-spatial.github.io/sf/articles/sf1.html#simple-feature-geometry-types),
@@ -94,56 +94,56 @@ So, in R we use packages that use GDAL in the background, such as
9494
example). GeoJSON adds the necessary specification to JSON for
9595
standardized storage of geographic feature data, but it is still a
9696
plain JSON text file.
97-
- The GeoJSON standard is maintained by the Internet Engineering Task
97+
- The GeoJSON standard is maintained by the Internet Engineering Task
9898
Force ([IETF](https://www.ietf.org/)), a large open standards
9999
organization that develops Internet standards under the auspices of
100100
the Internet Society.
101-
- Although the previous version of the GeoJSON standard – GeoJSON 2008
101+
- Although the previous version of the GeoJSON standard – GeoJSON 2008
102102
– is still a lot in use, it is
103103
[obsoleted](http://geojson.org/geojson-spec.html) and a new version
104104
**[RFC7946](https://tools.ietf.org/html/rfc7946)** is establishing.
105-
- This version is strict about the coordinate reference system
105+
- This version is strict about the coordinate reference system
106106
(CRS) – it is always [WGS84](https://epsg.io/4326) – and it also
107107
differs on a few other aspects (such as the recommendation for
108108
applications [not to
109109
inflate](https://tools.ietf.org/html/rfc7946#section-11.2)
110110
decimal coordinate precision).
111-
- RFC7946 solves the problem that quite a few libraries –
111+
- RFC7946 solves the problem that quite a few libraries –
112112
including GDAL – simply assumed WGS84 in GeoJSON 2008 (without
113113
checking or transforming), even though WGS84 was not a
114114
requirement of GeoJSON 2008 (it did support an explicit *crs*
115115
declaration). This resulted in inconveniences (cf. [this
116116
post](https://github.com/r-spatial/sf/issues/344#issue-229118527)
117117
in the `sf`-repository).
118-
- A [specific
118+
- A [specific
119119
section](https://gdal.org/drivers/vector/geojson.html#rfc-7946-write-support)
120120
in the documentation of GDAL’s GeoJSON driver gives a summary of
121121
the differences between both GeoJSON versions.
122-
- While GDAL by default still follows the GeoJSON 2008 format,\[3\]
122+
- While GDAL by default still follows the GeoJSON 2008 format,[^3]
123123
RFC7946 is supported by the option `RFC7946=YES`. Here, reprojection
124124
to WGS84 will happen automatically. It applies 7 decimal places for
125125
coordinates, i.e. approximately 1 cm. Given the advantages, ***we
126126
advise to explicitly use RFC7946***. Several functions in R allow
127127
the user to provide options that are passed to GDAL, so we can ask
128128
to deliver RFC7946 (see the
129129
[tutorial](../../tutorials/spatial_standards_vector/)).
130-
- In order to keep it manageable (text file size, usage in versioning
131-
systems\[4\] ) it can be wise to use GeoJSON for more simple cases
130+
- In order to keep it manageable (text file size, usage in versioning
131+
systems[^4] ) it can be wise to use GeoJSON for more simple cases
132132
(points and rather simple lines and polygons), and use the binary
133133
GeoPackage format for larger (more complex) cases.
134134

135135
## The GeoTIFF file format
136136

137-
- [GeoTIFF](https://en.wikipedia.org/wiki/GeoTIFF) is the preferred
137+
- [GeoTIFF](https://en.wikipedia.org/wiki/GeoTIFF) is the preferred
138138
single-file open standard for **raster** data. It adheres to the
139139
open [TIFF](https://en.wikipedia.org/wiki/TIFF) specification; hence
140140
it is a TIFF image file (`filename.tif`). It
141141
[uses](http://docs.opengeospatial.org/is/19-008r4/19-008r4.html#_geotiff_file_structure_and_geotiff_crs_and_models_principles_informative)
142142
a small set of reserved TIFF tags to store information about CRS,
143143
extent and resolution of the raster.
144-
- A GeoTIFF file can contain *one* or *multiple* rasters with the same
144+
- A GeoTIFF file can contain *one* or *multiple* rasters with the same
145145
CRS, extent and resolution.
146-
- The GeoTIFF standard is
146+
- The GeoTIFF standard is
147147
[maintained](https://www.opengeospatial.org/standards/geotiff) by
148148
the [Open Geospatial Consortium](https://www.opengeospatial.org/)
149149
(OGC), which stands out as a reference when it comes to open
@@ -175,21 +175,21 @@ Pebesma E. & Bivand R. (2019). Spatial Data Science.
175175

176176
</div>
177177

178-
1. Some problems with shapefiles are: they’re not an open format, they
179-
consist of multiple files and they have restrictions regarding file
180-
size, column name length, number of columns and the feature types
181-
that can be accommodated.
178+
[^1]: Some problems with shapefiles are: they’re not an open format,
179+
they consist of multiple files and they have restrictions regarding
180+
file size, column name length, number of columns and the feature
181+
types that can be accommodated.
182182

183-
2. Note that personal geodatabases have their size limited to 250-500
184-
MB; a GeoPackage can have a size of about 140 TB if the filesystem
185-
can handle it.
183+
[^2]: Note that personal geodatabases have their size limited to
184+
250-500 MB; a GeoPackage can have a size of about 140 TB if the
185+
filesystem can handle it.
186186

187-
3. Though GeoJSON 2008 is obsoleted, the now recommended RFC7946
187+
[^3]: Though GeoJSON 2008 is obsoleted, the now recommended RFC7946
188188
standard is still officially in a *proposal* stage. That is probably
189189
the reason why GDAL does not yet default to RFC7946. A somehow
190190
confusing stage, it seems.
191191

192-
4. When versioning GeoJSON files, mind the order of your data when
192+
[^4]: When versioning GeoJSON files, mind the order of your data when
193193
rewriting them: reordering could produce large diffs. Interested in
194194
combining GeoJSON and GitHub? [Surprise
195-
yourself](https://github.com/lyzidiamond/learn-geojson)\!
195+
yourself](https://github.com/lyzidiamond/learn-geojson)!

content/articles/inbo_software/index.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,6 @@ title: "Software by INBO: packages for environmentalists and ecologists!"
33
date: 2020-12-03
44
categories: ["development", "r", "statistics", "databases"]
55
tags: ["open science", "packages", "r", "python"]
6-
output:
7-
md_document:
8-
preserve_yaml: true
9-
variant: gfm
106
---
117

128
At the Research Institute for Nature and Forest (INBO), we are eager to sustain, promote and develop open-source software that is relevant to biodiversity researchers! This page lists **R and Python packages** which INBO developed or made a significant contribution to. Several of these packages continue being developed.

content/articles/inbo_stats_courses/index.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,6 @@ authors: [hansvancalster]
55
date: 2021-02-24
66
categories: ["r", "statistics"]
77
tags: ["r", "INLA", "mixed model", "uncertainty", "explorative data analysis", "analysis of variance", "generalized linear regression", "multivariate statistics"]
8-
output:
9-
md_document:
10-
preserve_yaml: true
11-
variant: gfm
128
---
139

1410
During the course of the years, we have taught many statistics courses at the Research Institute for Nature and Forest (INBO), both for scientists and technicians.

content/articles/open_science/index.Rmd

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,9 @@ bibliography: ../reproducible_research.bib
66
categories: ["literature"]
77
tags: ["literature", "open science"]
88
output:
9-
md_document:
10-
preserve_yaml: true
9+
md_document:
10+
preserve_yaml: true
11+
variant: gfm+footnotes
1112
---
1213

1314
This page lists **selected** literature and online resources. Some are related to existing tutorial pages, while others are not. They are supposed to be of high interest to this site's users.

content/articles/open_science/index.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,9 @@ bibliography: ../reproducible_research.bib
66
categories: ["literature"]
77
tags: ["literature", "open science"]
88
output:
9-
md_document:
10-
preserve_yaml: true
9+
md_document:
10+
preserve_yaml: true
11+
variant: gfm+footnotes
1112
---
1213

1314
This page lists **selected** literature and online resources. Some are
@@ -29,8 +30,7 @@ computing workflows](../computing).
2930
- Donati & Woolston (2017): how data science is becoming a large
3031
discipline
3132

32-
Focus on reproducible research
33-
------------------------------
33+
## Focus on reproducible research
3434

3535
- Stodden *et al.* (2014): **book** on computational reproducibility
3636
and (experiment) replicability; the three parts are *Tools*,
@@ -42,8 +42,7 @@ Focus on reproducible research
4242
- ROpenSci Contributors (2018): a comprehensive **overview** of
4343
aspects and R-oriented tools in reproducible research
4444

45-
Bibliography
46-
------------
45+
## Bibliography
4746

4847
Begley C.G., Buchan A.M. & Dirnagl U. (2015). Institutions must do their
4948
part for reproducibility. Nature 525 (7567): 25–27.

0 commit comments

Comments
 (0)