{"id":15359081,"url":"https://github.com/leouieda/talk-template","last_synced_at":"2025-04-15T07:22:14.263Z","repository":{"id":45132732,"uuid":"267073685","full_name":"leouieda/talk-template","owner":"leouieda","description":"Template for my reveal.js based slides","archived":false,"fork":false,"pushed_at":"2023-11-16T15:15:51.000Z","size":39180,"stargazers_count":15,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-28T17:47:55.528Z","etag":null,"topics":["css","html","reveal-js","reveal-slide-decks","revealjs","revealjs-theme","slides","talk","template"],"latest_commit_sha":null,"homepage":"https://www.leouieda.com/talk-template/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leouieda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-05-26T14:59:18.000Z","updated_at":"2024-10-30T11:23:17.000Z","dependencies_parsed_at":"2023-02-10T09:45:23.586Z","dependency_job_id":null,"html_url":"https://github.com/leouieda/talk-template","commit_stats":null,"previous_names":[],"tags_count":2,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftalk-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftalk-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftalk-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leouieda%2Ftalk-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leouieda","download_url":"https://codeload.github.com/leouieda/talk-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249024101,"owners_count":21200037,"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":["css","html","reveal-js","reveal-slide-decks","revealjs","revealjs-theme","slides","talk","template"],"created_at":"2024-10-01T12:43:46.971Z","updated_at":"2025-04-15T07:22:14.246Z","avatar_url":"https://github.com/leouieda.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Template for my reveal.js based slides\n\nThis is a template I use to make [reveal.js](https://revealjs.com/) slides\nfor talks and lectures.\nIt adds some custom styling and CSS classes for making columns, footnotes,\nand more.\n\n**Preview:** https://www.leouieda.com/talk-template\n\n\u003e The original inspiration is this template by Matthew Turk:\n\u003e https://github.com/matthewturk/mjt-talk-template\n\n## Using\n\n1. Click on the \"Use this template\" button or go to\n   https://github.com/leouieda/talk-template/generate to create a\n   new repository for your slides.\n1. Change the HTML title (the one that appears on the browser tab)\n   in `index.html`.\n1. Remove the Plausible Analytics script from the `\u003chead\u003e` in `index.html`.\n1. Preview the presentation by\n   [serving the slides locally](#serving-the-slides-locally).\n1. Add your content to `slides.md` and images to `assets`\n   (remove the images you don't want to use).\n1. Commit and push your changes.\n1. Make your presentation public by\n   [enabling GitHub Pages](#serving-on-github-pages).\n\n## What's included\n\n`index.html`: This is the master document that sets up reveal.js and\nits plugins and loads the slide content from `slides.md`.\n**Change the HTML `\u003ctitle\u003e` tag here**.\n\n`slides.md`: Markdown file with the actual slide content. The template\nincludes some slides that demo the custom CSS classes available.\n**Add your content here.**\n\n`css/style.less`: Custom styling and CSS classes (using\n[Less](http://lesscss.org/)). Edit to tweak colours, sizes, fonts,\nspacing, etc.\n\n`assets`: Images used in the presentation. You can probably delete all\nof these when making your slides. Replace the `favicon.png` with a\n32 x 32 px image to customize the icon (this is set in `index.html`).\n\n`fonts`: Sources for the fonts used:\n[FontAwesome](https://fontawesome.com/),\n[Atkinson Hyperlegible](https://brailleinstitute.org/freefont),\n[Ubuntu Mono](https://design.ubuntu.com/font/).\nIncluded in the repository for offline access. You could remove them and\ninclude fonts from a CDN (like Google Fonts) in `index.html`.\n\n`packages`: \"Vendored\" versions of reveal.js, Less, and\n[KaTeX](https://katex.org/) (for maths) that are used.\nHaving them in the repository is important for using the slides offline\n(on a plane or lecture room without easy internet access).\n\n`serve.py`: Python script that serves the slides and reloads them\nwhenever the source files change. Very handy for development.\nSee below for instructions.\n\n## Serving the slides locally\n\nUnfortunately, you can't just open the `index.html` file on browser\nto view your slides.\nReveal.js requires an actual local server.\nYou can set one up however you'd like.\nBelow, I provide instructions for doing so in Python (which is what\nI use most of the time) but it would work with any other local\nserver.\n\nFirst, install the [livereload](https://github.com/lepture/python-livereload)\nPython package:\n\n```\npip install livereload\n```\n\nor\n\n```\nconda install livereload -c conda-forge\n```\n\nThen, start a server at http://localhost:8008 by running:\n\n```\npython serve.py\n```\n\nThe slides will open on your default browser and will automatically reload\nwhen you update any of the files in the repository.\n\n## Serving on GitHub Pages\n\nGo to your repository \"Settings \u003e Pages\" and select \"Source\" as the\n`main` branch and `/ (root)`. You probably want to select \"Enforce HTTPS\"\nas well.\n\nYour slides should now be served at https://USERNAME.github.io/REPOSITORY\nor equivalent if you're using a custom domain.\nIt may take a little while for this to happen.\n\nFor example, this template is served at\nhttps://www.leouieda.com/talk-template.\n\n## Exporting to PDF\n\nYou can save your slides to PDF for a backup or to distribute\n(I find students like this because they can annotate the PDF).\nTo do so, add `?print-pdf` to the end of the URL (either local\nserver or hosted) and then print the page to PDF.\n\nThis **works best on Chrome/Chromium**. The slides tend to be\ndistorted on Firefox for some reason.\n\n**WARNING:** Videos and gifs don't work on PDFs.\n\n## License\n\nThe template (`slides.md`, `index.html`, and `css/style.less`) is licensed under a\n\u003ca href=\"https://creativecommons.org/licenses/by/4.0/\"\u003eCreative Commons\nAttribution 4.0 International License\u003c/a\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleouieda%2Ftalk-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleouieda%2Ftalk-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleouieda%2Ftalk-template/lists"}