https://github.com/annakrystalli/test-rse-template
Science Score: 26.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (14.6%) to scientific vocabulary
Repository
Basic Info
- Host: GitHub
- Owner: annakrystalli
- Language: HTML
- Default Branch: master
- Size: 108 KB
Statistics
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
Version control through Git, GitHub & GitKraken for researchers
Source of the website of a short course.
It is powered by Hugo and the following themes:
Slides for each section are listed in the menu and opened in a new tab (thanks to a custom menu layout, compared to the original Hugo learn theme).
Some Markdown content is generated with R Markdown, using hugodown.
The website is deployed by Netlify.
Why these tools?
Why use Hugo for both the website and slidedecks, and not, say Hugo+hugodown for pages and xaringan for slides? This way the source of slides is html produced by Hugo from Markdown content. It allows me to use:
- downlit syntax highlighting for slides created from R Markdown with hugodown output format;
- Chroma syntax highlighting for other languages;
- emojis!
:grin:works in slides; - Shortcodes in slides, should I choose to.
Also, because slides are in the content, they are indexed by the Hugo learn theme so searchable!
Using the Template
Software requirements
You will need Go (> 1.12) and Hugo installed.
Creating a new course material wesite
- Make copy of template
- Edit
config.tomlproviding details like workshop title, description, authors and urls to the GitHub repository - Build static pages with
hugo -D- if you encounter any errors for example, regarding missing shortcodes, you made need to clean your module cache with
hugo mod clean
- if you encounter any errors for example, regarding missing shortcodes, you made need to clean your module cache with
- Serve site locally
hugo server -D- Navigate to http://localhost:1313/ to view
Creating a new file
To create a new file use the hugo new command
hugo new hugo new 01-getting-started/introduction.md
To use one of the archetypes, for example to create a new chapter, use the flag --kind:
hugo new --kind chapter 02-r-rstudio/_index.md
Include slides in a chapter
To include reveal.js slides in a chapter, ensure the header YAML in the chapter index.md file includes slides: true
Credits
The workshop materials website template is based on the hugo-theme-learn, reveal-hugo Hugo themes and further work and configuration by Maëlle Salmon for her course site on Scientific blogging with R Markdown.
Owner
- Name: Anna Krystalli
- Login: annakrystalli
- Kind: user
- Location: Syros, Greece
- Company: @r-rse
- Website: https://www.r-rse.eu
- Twitter: annakrystalli
- Repositories: 240
- Profile: https://github.com/annakrystalli
Research Software Engineering Service in #rstats at @r-rse. Ex @RSE-Sheffield. Editor @ropensci. Core team member @reprohack. Available for hire! 🚀😎
GitHub Events
Total
Last Year
Committers
Last synced: over 1 year ago
Top Committers
| Name | Commits | |
|---|---|---|
| Anna Krystalli | a****i@g****m | 2 |
Issues and Pull Requests
Last synced: about 1 year ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0