Skip to content

Commit 0ebb9f0

Browse files
committed
fix broken links, a follow up to #13
1 parent 7dec50d commit 0ebb9f0

File tree

13 files changed

+60
-25
lines changed

13 files changed

+60
-25
lines changed

Gemfile

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,3 +26,7 @@ gem "wdm", "~> 0.1.0" if Gem.win_platform?
2626
gem "csv"
2727
gem "base64"
2828
gem "bigdecimal"
29+
30+
# https://danielsieger.com/blog/2021/03/28/check-broken-links-jekyll.html
31+
# https://github.com/gjtorikian/html-proofer/blob/main/README.md
32+
gem "html-proofer"

Gemfile.lock

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,20 @@ GEM
1111
em-websocket (0.5.3)
1212
eventmachine (>= 0.12.9)
1313
http_parser.rb (~> 0)
14+
ethon (0.16.0)
15+
ffi (>= 1.15.0)
1416
eventmachine (1.2.7)
1517
ffi (1.17.0)
1618
forwardable-extended (2.6.0)
19+
html-proofer (4.4.3)
20+
addressable (~> 2.3)
21+
mercenary (~> 0.3)
22+
nokogiri (~> 1.13)
23+
parallel (~> 1.10)
24+
rainbow (~> 3.0)
25+
typhoeus (~> 1.3)
26+
yell (~> 2.0)
27+
zeitwerk (~> 2.5)
1728
http_parser.rb (0.8.0)
1829
i18n (1.14.5)
1930
concurrent-ruby (~> 1.0)
@@ -57,9 +68,14 @@ GEM
5768
minima-reboot (1.0.33)
5869
jekyll (>= 3.6, < 5.0)
5970
jekyll-seo-tag (~> 2.7)
71+
nokogiri (1.14.0-x86_64-linux)
72+
racc (~> 1.4)
73+
parallel (1.26.3)
6074
pathutil (0.16.2)
6175
forwardable-extended (~> 2.6)
6276
public_suffix (6.0.1)
77+
racc (1.5.1)
78+
rainbow (3.1.1)
6379
rb-fsevent (0.11.2)
6480
rb-inotify (0.11.1)
6581
ffi (~> 1.0)
@@ -74,15 +90,20 @@ GEM
7490
rb-fsevent (~> 0.9, >= 0.9.4)
7591
rb-inotify (~> 0.9, >= 0.9.7)
7692
strscan (3.1.0)
93+
typhoeus (1.4.0)
94+
ethon (>= 0.9.0)
7795
webrick (1.8.1)
96+
yell (2.2.2)
97+
zeitwerk (2.6.18)
7898

7999
PLATFORMS
80-
ruby
100+
x86_64-linux
81101

82102
DEPENDENCIES
83103
base64
84104
bigdecimal
85105
csv
106+
html-proofer
86107
jekyll (~> 3.10)
87108
jekyll-redirect-from
88109
jekyll-remote-theme

Makefile

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,10 @@ preview:
55
build:
66
bundle exec jekyll clean
77
bundle exec jekyll build --trace
8+
9+
# https://github.com/linaro-its/jekyll-link-checker/wiki/Using-the-link-checker
10+
checklinks: build
11+
docker run --rm -it -v /etc/passwd:/etc/passwd:ro -v /etc/group:/etc/group:ro -u "$(id -u)":"$(id -g)" -v `pwd`:/srv linaroits/linkcheck --skip-path `/_includes`
12+
13+
proof: build
14+
bundle exec htmlproofer ./_site --enforce_https=false --ignore-status-codes 999,403,429 --ignore-urls localhost:4000,/register

_includes/footer.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
{% endif %}
1919
{% if site.license %}
2020
<li class="text-secondary">Published under <a rel="license" href="{{ site.license.link }}">{{ site.license.text }}</a></br>
21-
<a href="{{ site.license.link }}"><img title="license logo" src="{{ site.license.logo }}" /></a></li>
21+
<a href="{{ site.license.link }}"><img alt="license logo" title="license logo" src="{{ site.license.logo }}" /></a></li>
2222
{% endif %}
2323
</ul>
2424
</div>

_layouts/spec.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
<a class="h3 m-0 text-dark" href="{{ page_url }}"><strong>{{ page.title | escape }}</strong><br/>version {{ page.version }}</a>
1414

1515
<div id="spec-logo" class="text-right navbar-light">
16-
<a href="{{ '/' | relative_url }}" title="project home page"><img src="{{ 'img/codecheck_logo.svg' | relative_url }}" title="CODECHECK logo" /></a>
16+
<a href="{{ '/' | relative_url }}" title="project home page"><img alt="CODECHECK logo" src="{{ 'img/codecheck_logo.svg' | relative_url }}" title="CODECHECK logo" /></a>
1717
</div>
1818
</div>
1919
</header>

get-involved.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,4 +41,4 @@ We would be happy to list your journal of conference on our website after we hav
4141
## As a developer or science communicator
4242

4343
CODECHECK is a community effort, and your help is welcome across all tasks that the team faces.
44-
If you want to write code to assisst codecheckers to conduct more effective reviews or to streamline the CODECHECK review processes, or if you want to help presenting and sharing CODECHECK's vision and educate others on code executability checks - then _please get in touch with the [CODECHECK team](partners/#team) (see email links in footer)_.
44+
If you want to write code to assisst codecheckers to conduct more effective reviews or to streamline the CODECHECK review processes, or if you want to help presenting and sharing CODECHECK's vision and educate others on code executability checks - then _please get in touch with the [CODECHECK team](/partners/#team) (see email links in footer)_.

guide/bundle.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,4 +31,4 @@ R Markdown has some nice features that are helpful for writing a report.
3131
- Literate programming and code chunks (hidden, visible) with nice looking and mostly hastle free PDF output (using [tinytex](https://yihui.name/tinytex/))
3232
- You can configure document metadata, e.g. the title or subtitle, anywhere in the document, so you can choose to configure them only in the `codecheck.yml`, see [this example](https://github.com/codecheckers/Piccolo-2020/blob/master/codecheck/piccolo2020-codecheck.Rmd)
3333
- The CODECHECK [assistant](https://github.com/codecheckers/assistant/) is an R package that streamlines report writing with R
34-
- You can capture the metadata of the computing environment in an automatically generated _colophon_ that lists installed packages and session information (using `sessionInfo()` or `devtools::session_info()`), see for example [this one](https://github.com/benmarwick/rrtools/blob/master/inst/templates/paper.qmd#L119) in the template in `rrtools` by Ben Marwick, or a _reproducibility receipt_, see [this code example](https://github.com/PredictiveEcology/pemisc/blob/cf1516ff3893a7ffbfe1ae6623c0350c47c3e1b2/R/reproducibilityReceipt.R#L20), which adds git repository information and information about external libraries to the session information
34+
- You can capture the metadata of the computing environment in an automatically generated _colophon_ that lists installed packages and session information (using `sessionInfo()` or `devtools::session_info()`), see for example [this one](https://github.com/benmarwick/rrtools/blob/master/inst/templates/paper.qmd) in the template from `rrtools` by Ben Marwick, or a _reproducibility receipt_, see [this code example](https://github.com/PredictiveEcology/pemisc/blob/cf1516ff3893a7ffbfe1ae6623c0350c47c3e1b2/R/reproducibilityReceipt.R), which adds git repository information and information about external libraries to the session information

guide/community-workflow.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ It is worth taking a look around for such checklists for your discipline or meth
3535
From our experience, **documentation** is the key.
3636
A typical measure for a good level of documentation is to provide at least so much information as the author would themselves need after a longer period of time, e.g., 1 year, to run the analysis again.
3737
Any researcher, even if not familiar with the software stack, should be able to run the workflow and find out if the code works.
38-
Structured information about the computing environment, such as a [_colophon_](https://github.com/benmarwick/rrtools/blob/master/inst/templates/paper.Rmd#L105) or _"reproducibility receipt"_ in computational notebooks (see [this discussion on Twitter](https://twitter.com/MilesMcBain/status/1263272935197782016?s=09)) are very helpful.
38+
Structured information about the computing environment, such as a _colophon_ or _reproducibility receipt_ are very helpful, see the [CODECHECK bundle guide](/guide/bundle).
3939

4040
Common sense shall be applied to decide about the suitable amount of data and to handle big datasets, sensitive datasets with privacy concerns, and long execution times.
4141
For example, data may be deposited depending on community practices in remote repositories, synthetic data may be used, subsets or preprocessed data may be included, or protected access to information may be provided (e.g. cloud-based data enclaves).
@@ -83,7 +83,7 @@ When your workflow is ready to be CODECHECK, open an issue on the [CODECHECK reg
8383

8484
After the publication of the CODECHECK certificate, add a reference to the certificate in your paper, e.g., in a section describing your workflow or in the acknowledgements:
8585

86-
> _A CODECHECK certificate is available confirming that [all of the, a (significant) part of the, the] computations underlying this article could be independently executed: <https://doi.org/certificate-DOI>._
86+
> _A CODECHECK certificate is available confirming that [all of the, a (significant) part of the, the] computations underlying this article could be independently executed: `DOI of the certificate here`.
8787
8888
------
8989

@@ -194,7 +194,7 @@ When a new issue is assigned to a codecheck editor in the register, here are a f
194194
- Ask the codechecker to add/update all required metadata in the `codecheck.yml` and updated the certificate report (especially the final DOI!), double-check the information in the metadata and the actual certificate; wait until the certificate is published with its own DOI.
195195
- Trigger a rebuild of the register by adding the CODECHECK to the `register.csv` file; you may add a `closes #N` statement in the commit message to close the isue.
196196
- Clear up the labels of the register issue - all labels except the [`community`](https://github.com/codecheckers/register/labels/community)/[`journal`](https://github.com/codecheckers/register/labels/journal)/[`conference/workshop`](https://github.com/codecheckers/register/labels/conference%2Fworkshop) should be removed.
197-
- "Archive" the repository clone in the codecheckers organisation on GitHub/the cdchk organisation on GitLab ([instructions for GitHub](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/about-archiving-repositories), [instructions for GitLab](https://docs.gitlab.com/ee/user/project/settings/#archiving-a-project))
197+
- "Archive" the repository clone in the codecheckers organisation on GitHub/the cdchk organisation on GitLab ([instructions for GitHub](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/about-archiving-repositories), [instructions for GitLab](https://docs.gitlab.com/ee/user/project/working_with_projects.html#archive-a-project))
198198
- Close the issue on the register.
199199

200200
------

index.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ head_inline: |
99

1010
<div class="row banner">
1111
<div class="col-6 col-lg">
12-
<img src="img/codecheck_logo.svg" width="100%" alt="CODECHECK logo" />
12+
<img alt="CODECHECK logo" src="img/codecheck_logo.svg" width="100%" alt="CODECHECK logo" />
1313
<p class="text-secondary text-justify"><em>Independent execution of computations underlying research articles.</em></p>
1414
</div>
1515

@@ -113,7 +113,7 @@ Learn more about the Reproducible AGILE initiative at <https://reproducible-agil
113113
The CODECHECK team is grateful about the continued interest from the research community on the topic of evaluating code and workflows as part of scholarly communication and peer review.
114114

115115
Stephen gave a talk at the [**2022 Toronto Workshop on Reproducibility**](https://canssiontario.utoronto.ca/event/toronto-workshop-on-reproducibility/) organised by [Rohan Alexander](https://rohanalexander.com/).
116-
You can find the [slides online](https://sje30.github.io/talks/2022/codecheck22.html#1) and also watch the [**recording on YouTube**](https://www.youtube.com/watch?v=TgDgcqtsFvE) - very worth a look because of the great Q&A at the end!
116+
You can find the [slides online](https://sje30.github.io/talks/2022/codecheck22.html) and also watch the [**recording on YouTube**](https://www.youtube.com/watch?v=TgDgcqtsFvE) - very worth a look because of the great Q&A at the end!
117117

118118
Stephen presented **CODECHECK: An Open Science initiative for the independent execution of computations underlying research articles during peer review to improve reproducibility** ([slides](https://bit.ly/codecheck21)) in May 2021 at the [Reproducibility Tea Southhampton](https://reproducibilitea.org/journal-clubs/#Southampton).
119119

@@ -157,11 +157,13 @@ A [Nature News article](https://doi.org/10.1038/d41586-020-01685-y) by [Dalmeet
157157
158158
### 2019-11 | MUNIN conference presentation
159159

160-
Stephen Eglen presented CODECHECK at [The 14th Munin Conference on Scholarly Publishing 2019](https://site.uit.no/muninconf/).
160+
Stephen Eglen presented CODECHECK at [The 14th Munin Conference on Scholarly Publishing 2019](https://site.uit.no/muninconf/) with the submission "CODECHECK: An open-science initiative to facilitate sharing of computer programs and results presented in scientific publications", see <https://doi.org/10.7557/5.4910>.
161161

162-
> Take a look at the [poster](https://septentrio.uit.no/index.php/SCS/article/view/4910/4893) and the [slides](https://septentrio.uit.no/index.php/SCS/article/view/4910/4900), or watch the [video recording](https://mediasite.uit.no/Mediasite/Play/8027873496dc465ebc4b9b3ab0338ad01d?playFrom=1772000).
163-
>
164-
> [![screenshot of livestream of the talk by Stephen Eglen at MUNIN 2019](/img/munin-2019.jpg)](https://mediasite.uit.no/Mediasite/Play/8027873496dc465ebc4b9b3ab0338ad01d?playFrom=1772000)
162+
Take a look at the [poster](https://septentrio.uit.no/index.php/SCS/article/view/4910/4893) and the [slides](https://septentrio.uit.no/index.php/SCS/article/view/4910/4900).
163+
164+
<!-- or watch the [video recording](https://mediasite.uit.no/Mediasite/Play/8027873496dc465ebc4b9b3ab0338ad01d?playFrom=1772000). -->
165+
166+
> ![screenshot of livestream of the talk by Stephen Eglen at MUNIN 2019](/img/munin-2019.jpg)
165167
166168
------
167169

nl-workshop1.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,12 @@ permalink: /nl-workshop1/
77
## UPDATE: We have successfully completed our first workshop! Read on...
88

99
<p align="center">
10-
<img src="https://github.com/codecheckers/codecheckers.github.io/assets/150461262/f91ed93a-2624-457d-bc2a-a01353891f51" alt = "Delft workshop participants" width="50%" height = "50%">
10+
<img src="https://github.com/codecheckers/codecheckers.github.io/assets/150461262/f91ed93a-2624-457d-bc2a-a01353891f51" alt="Delft workshop participants" width="50%" height = "50%">
1111
</p>
1212

1313
On the 30th of May 2024, the CODECHECK-NL team organised its first roadshow event in Delft. The event marks the beginning of a series of four workshops to be conducted across the Netherlands, where we carry out live codechecks with authors and reviewers, while also training a new batch of codecheckers across universities in the Netherlands.
1414

15-
The Delft event kicked off in the morning with 20 participants and members of the CODECHECK-NL team. We began with a short introduction to the project and its scope by Frank Ostermann (PI for the project, based at the University of Twente), followed by an introduction to codechecking by Stephen Eglen, one of the founders of CODECHECK, and a computational neuroscientist based at the University of Cambridge. Stephen's presentation (which can be found [here](https://sje30.github.io/talks/2024/codecheck2024-02.html#/title-slide)) introduced the philosophy behind codecheck, and the importance of the concept of “good enough” in facilitating code reproducibility. The introduction was followed by a live demo codecheck, conducted on a project submitted by Filip Surma of Delft University of Technology. Curious to see what a CODECHECK certificate looks like? See Filip's certificate [here](https://zenodo.org/records/11403956).
15+
The Delft event kicked off in the morning with 20 participants and members of the CODECHECK-NL team. We began with a short introduction to the project and its scope by Frank Ostermann (PI for the project, based at the University of Twente), followed by an introduction to codechecking by Stephen Eglen, one of the founders of CODECHECK, and a computational neuroscientist based at the University of Cambridge. Stephen's presentation (which can be found [here](https://sje30.github.io/talks/2024/codecheck2024-02.html)) introduced the philosophy behind codecheck, and the importance of the concept of “good enough” in facilitating code reproducibility. The introduction was followed by a live demo codecheck, conducted on a project submitted by Filip Surma of Delft University of Technology. Curious to see what a CODECHECK certificate looks like? See Filip's certificate [here](https://zenodo.org/records/11403956).
1616

1717
Following lunch and the successful codecheck of Filip's project, in collaboration with the participants, in the afternoon we moved into breakout sessions, codechecking three more projects in smaller groups, with authors also present during the process. Three more successful codechecks later, participants had a much clearer picture of what codechecks are, how the process works, and how easy or difficult it can be to run or reuse someone else's code!
1818

0 commit comments

Comments
 (0)