{"id":19891766,"url":"https://github.com/inbo/tutorials","last_synced_at":"2025-07-25T22:12:48.946Z","repository":{"id":37431114,"uuid":"69578154","full_name":"inbo/tutorials","owner":"inbo","description":"A collection of technical tutorials for INBO (and anyone who's interested)","archived":false,"fork":false,"pushed_at":"2025-04-10T06:00:44.000Z","size":117043,"stargazers_count":23,"open_issues_count":32,"forks_count":9,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-14T12:46:43.331Z","etag":null,"topics":["r","tutorial"],"latest_commit_sha":null,"homepage":"https://tutorials.inbo.be/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/inbo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-09-29T14:56:17.000Z","updated_at":"2025-03-31T10:08:56.000Z","dependencies_parsed_at":"2023-09-27T18:52:22.054Z","dependency_job_id":"6c5fb648-51f0-433e-81d5-22a35406b032","html_url":"https://github.com/inbo/tutorials","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inbo%2Ftutorials","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inbo%2Ftutorials/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inbo%2Ftutorials/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inbo%2Ftutorials/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/inbo","download_url":"https://codeload.github.com/inbo/tutorials/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252088436,"owners_count":21692795,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["r","tutorial"],"created_at":"2024-11-12T18:19:31.070Z","updated_at":"2025-05-02T18:31:22.902Z","avatar_url":"https://github.com/inbo.png","language":"HTML","readme":"\n# Tutorials\n\n[![Deploy to GitHub pages](https://github.com/inbo/tutorials/actions/workflows/deploy-gh-pages.yml/badge.svg?branch=master\u0026event=push)](https://github.com/inbo/tutorials/actions/workflows/deploy-gh-pages.yml)\n\nThis repository contains the source files for the [INBO tutorials website](https://inbo.github.io/tutorials/): a collection of instructions on the use, installation and development of research software at the Research Institute of Nature and Forest (INBO).\n\n## Adding content\n\nNew tutorials should go in a new directory in `content/tutorials`. Use plain markdown files (`.md`) as much a possible. Use Rmarkdown files (`.Rmd`) when calculations in R are required. For more information about creating a new tutorial, check the [create tutorial](https://inbo.github.io/tutorials/create_tutorial/) page.\n\n## Reviewing the website in a pull request (before merging)\n\nThanks to GitHub Actions, an artifact (=zip file) of the rendered website is now automatically created on each pull request.\n[Learn more](https://github.com/inbo/tutorials/blob/master/.github/pull_request_template.md#previewing-the-pull-request) about showing the development website of a pull request in your browser.\n\n## Building the site\n\nThe technology used to create the website is [Hugo](https://gohugo.io/), a static website generator. Hugo will process all the markdown files - ignoring Rmd, which is why these need to be knit beforehand - and create the necessary files (html, css, js) for the website. These are served from the [`gh-pages` branch](https://github.com/inbo/tutorials/tree/gh-pages).\n\n### GitHub actions\n\n[GitHub actions](https://github.com/features/actions) will automatically run the steps above ([install Hugo, download theme, run Hugo, deploy website](.github/workflows/deploy-gh-pages.yml)) for every commit to the master branch. You will see in the [actions page](https://github.com/inbo/tutorials/actions/workflows/deploy-gh-pages.yml) if the build was successful. If not, check the logs to figure out what went wrong.\n\n### Building the site on your local computer\n\n1. [Install hugo](https://gohugo.io/getting-started/installing/)\n2. Clone the tutorials repository\n3. In the cloned tutorials directory, install the theme with `git clone https://github.com/MunifTanjim/minimo.git --branch v2.9.0 themes/minimo`\n4. Build and serve the site with `hugo server`\n\nFor more information, see [Hugo's getting started documentation](https://gohugo.io/getting-started/usage/).\n\n### Customizing the theme\n\nThe tutorials website makes use of the Hugo theme [minimo](https://themes.gohugo.io/minimo/). This theme is not included in the repository, but [downloaded by GitHub pages](https://github.com/inbo/tutorials/blob/262f305ef66fd4fc46ef7b2a9dce36cd2ad3e0d9/.github/workflows/deploy-gh-pages.yml#L18-L23) at build time. This avoids clutter and changes to the theme itself. To customize the theme:\n\n1. Browse the `layouts` directory in the [minimo repository](https://github.com/MunifTanjim/minimo/tree/master/layouts) to see which template file you want to customize\n2. Copy the template file to the same path in the [`layouts`](layouts/) directory of this repository\n3. Edit the file to the desired effect. E.g. [this update](https://github.com/inbo/tutorials/blob/b122758ef8d98977e51335bf227a2cf8c1f6bbd7/layouts/partials/entry/meta.html#L15-L16) to the [original minimo file](https://github.com/MunifTanjim/minimo/blob/4436676dd44c767faaa4fa85f8a24527ce61ba81/layouts/partials/entry/meta.html#L15) adds a \"edit this page\" link for every page.\n4. Hugo will now use your customized file instead of the default theme file.\n\nFor more information, see the [Hugo theme customization documentation](https://gohugo.io/getting-started/quick-start/#step-6-customize-the-theme). To test theme customization, it is best to build the site on your local computer (see above).\n\n## Contributors\n\n[List of contributors](https://github.com/inbo/tutorials/graphs/contributors)\n\n## License\n\n[Creative Commons Attribution](https://creativecommons.org/licenses/by/4.0/) for [content](content) / [MIT License](https://github.com/inbo/tutorials/blob/master/LICENSE) for source code.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finbo%2Ftutorials","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finbo%2Ftutorials","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finbo%2Ftutorials/lists"}