Source code for the UQ Library Technology Training website, on which you can find the material (and links to files) for our technology training sessions. Go to the website for a convenient listing of resources.
The website is built using Quarto.
Most sessions are designed to be hands-on.
All programming sessions use the "live-coding" format in which the instructor and the attendees type and execute commands together. A collaborative online pad (e.g. Etherpad, CryptPad and HedgeDoc) can be used to list useful links, challenges, and to interact during the session.
The following sessions are not currently maintained.
| Title | Course notes | Live collaborative pad |
|---|---|---|
| Introduction to R for Humanities | md source | html |
All of the information on this repository (https://github.com/uqlibrary/technology-training) is freely available under the Creative Commons - Attribution 4.0 International Licence. You may re-use and re-mix the material in any way you wish, without asking permission, provided you cite the original source. However, we'd love to hear about what you do with it!
Part of this repository is based on Paula Andrea Martinez's work available under the same CC-By-4.0 licence.
If you would like to develop on top of this, please cite the source as mentioned above, and conserve the git history if possible (so authors are credited).
You can raise an issue or submit a change in this repository if you spot something that needs fixing.
To modify lesson materials:
Binary files are usually kept in a separate "assets" repository.
- Go to the appropriate folder in the assets repository
- Press "Add file" > "Upload files"
- Choose the file, include an appropriate message (e.g. "Updated excel notes") and press "Commit changes"
To update a file, make sure the file name and location are the same. Otherwise, the website will still link to the old file.
If you've used a new name, or are uploading a new file, you will also need to update the website by changing the corresponding .qmd file's link.
- Modify the corresponding Quarto (
qmd) file. - Preview the rendered page locally to see the changes:
quarto preview <path/to/the_source.qmd>
- Once you are happy with the changes, publish them:
quarto publish gh-pages
- And don't forget to commit and push your changes to this repository.
If you have questions about contributing to the material, please contact the UQ Library.
For images that are not generated by code, you can use this syntax for caption and alternative text:
{fig-alt="Alternative text goes here"}If the image (a graph, for example) is generated by a code chunk, use the chunk options fig-cap and fig-alt:
```{language}
#| fig-cap: "Caption goes here"
#| fig-alt: "Alternative text goes here"
Executable code goes here
```Learn more about alt text:
- alt text in Quarto
- Wikipedia's guide on alt text
- Wikipedia's example of alt text
- Amy Cesal's article on writing alt text for data visualisation
If you are part of the UQ community, you can contact the technology trainers for a 1-on-1 consultation, an enquiry about sessions, or any question about the software supported by the UQ Library: training<commercial at>library.uq.edu.au