{"id":23832016,"url":"https://github.com/csdms/workshop-template","last_synced_at":"2025-08-01T18:03:55.299Z","repository":{"id":145028030,"uuid":"64729059","full_name":"csdms/workshop-template","owner":"csdms","description":null,"archived":false,"fork":false,"pushed_at":"2016-08-02T18:35:19.000Z","size":1390,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":9,"default_branch":"gh-pages","last_synced_at":"2025-02-22T03:14:38.087Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/csdms.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION","codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-08-02T06:08:23.000Z","updated_at":"2016-08-02T18:35:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"8ffb514a-c6a9-45e6-93da-71e8a11b5a06","html_url":"https://github.com/csdms/workshop-template","commit_stats":{"total_commits":546,"total_committers":68,"mean_commits":8.029411764705882,"dds":0.684981684981685,"last_synced_commit":"b3060aee74e1445542a802aa9e58326fd0eb99aa"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/csdms/workshop-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csdms%2Fworkshop-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csdms%2Fworkshop-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csdms%2Fworkshop-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csdms%2Fworkshop-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/csdms","download_url":"https://codeload.github.com/csdms/workshop-template/tar.gz/refs/heads/gh-pages","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csdms%2Fworkshop-template/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268272380,"owners_count":24223782,"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","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-01-02T14:17:00.439Z","updated_at":"2025-08-01T18:03:55.232Z","avatar_url":"https://github.com/csdms.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# workshop-template\n\nThis repository is [Software Carpentry][swc-site] and [Data Carpentry][dc-site]'s\ntemplate for creating websites for workshops.\n\n1.  Please *do not fork this repository directly on GitHub.*\n    Instead, please use GitHub's importer following [the instructions below](#creating-a-repository)\n    to create a website repository for your workshop.\n\n2.  Please *do your work in your repository's `gh-pages` branch*,\n    since that is what is\n    [automatically published as a website by GitHub][github-project-pages].\n\n3.  Once you are done,\n    please **send your repository's URL to the [Software Carpentry administrator][contact]**.\n    We build the list of workshops on our websites from the data included in your `index.html` page.\n    We can only do that if you [customize][customization] that page correctly\n    *and* send us a link to your workshop website.\n\nIf you run into problems,\nor have ideas about how to make this process simpler,\nplease [get in touch](#getting-and-giving-help).\nThe pages on [customizing your website][customization],\nthe [FAQ][faq],\nand the [design notes][design] have more detail on what we do and why.\nAnd please note:\nif you are teaching Git,\nplease [create a separate repository](#setting-up-a-separate-repository-for-learners)\nfor your learners to practice in.\n\n## Creating a Repository\n\n1.  Log in to GitHub.\n    (If you do not have an account, you can quickly create one for free.)\n    You must be logged in for the remaining steps to work.\n\n2.  Go to [GitHub's importer][importer].\n\n3.  Paste the url of this repo as the old repository to clone:\n    \u003chttps://github.com/csdms/workshop-template\u003e.\n\n4.  Select the owner for your new repository.\n    (This will probably be you, but may instead be an organization you belong to.)\n\n5.  Choose a name for your workshop website repository.\n    This name should have the form `YYYY-MM-DD-site`,\n    e.g., `2016-12-01-miskatonic`,\n    where `YYYY-MM-DD` is the start date of the workshop.\n\n6.  Make sure the repository is public.\n\n7.  At this point, you should have a page like this:\n\n    ![](fig/using-github-import.png?raw=true)\n\n    You can now click \"Begin Import\".\n    When the process is done,\n    you will receive a message like\n    \"Importing complete! Your new repository gvwilson/2016-12-01-miskatonic is ready.\"\n    and you can go to the new repository by clicking on the name.\n\n**Note:**\nsome people have had intermittent errors during the import process,\npossibly because of the network timing out.\nIf you experience a problem, please re-try;\nif the problem persists,\nplease [get in touch](#getting-and-giving-help).\n\n## Customizing Your Website\n\n1.  Go into your newly-created repository,\n    which will be at `https://github.com/your_username/YYYY-MM-DD-site`.\n    For example,\n    if your username is `gvwilson`,\n    the repository's URL will be `https://github.com/gvwilson/2016-12-01-miskatonic`.\n\n2.  Edit the header of `index.html` to customize the list of instructors,\n    workshop venue, etc. \n    You can do this in the browser by clicking on it in the file view on GitHub\n    and then selecting the pencil icon in the menu bar:\n\n    ![](fig/edit-index-file-menu-bar.png?raw=true)\n    \n    Editing hints are embedded in `index.html`,\n    and full instructions are in [the customization instructions][customization].\n\n3.  Alternatively,\n    if you are already familiar with Git,\n    you can clone the repository to your desktop,\n    edit `index.html` there,\n    and push your changes back to the repository.\n\n    ~~~\n    git clone -b gh-pages https://github.com/your_username/YYYY-MM-DD-site\n    ~~~\n\n    You should specify `-b gh-pages` because the imported repository doesn't have a `master` branch.\n\n    In order to view your changes once you are done editing,\n    you must push to your GitHub repository:\n\n    ~~~\n    git push origin gh-pages\n    ~~~\n\n    **Note:**\n    please do all of your work in your repository's `gh-pages` branch,\n    since [GitHub automatically publishes that as a website][github-project-pages].\n\n5.  When you are done editing,\n    go to the GitHub Pages URL for your workshop and preview your changes.\n    In the example above, this is `https://gvwilson.github.io/2016-12-01-miskatonic`.\n\n**Note:**\nthis template includes some files and directories that most workshops do not need,\nbut which provide a standard place to put extra content if desired.\nSee the [design notes][design] for more information about these.\n\nFurther instructions are available in [the customization instructions][customization].\nThis [FAQ][faq] includes a few extra tips (additions are always welcome)\nand these notes on [the background and design][design] of this template may help as well.\n\n## Checking Your Changes\n\nIf you want to preview your changes on your own machine before publishing them on GitHub,\nyou can do so as described below.\n\n1.  Install the software [described below](#installing-software).\n    This may require some work,\n    so feel free to preview by pushing to the website.\n\n2.  Run the command:\n\n    ~~~\n    $ jekyll serve\n    ~~~\n\n    and go to \u003chttp://0.0.0.0:4000\u003e to preview your site.\n    You can also run this command by typing `make serve`\n    (assuming you have Make installed).\n\n3.  Run the command `python bin/workshop_check.py index.html`\n    to check for a few common errors in your workshop's home page.\n    (You must have Python 3 installed to do this.)\n    If you have Make installed,\n    you can also run this command by typing `make workshop-check`.\n\n## Creating Extra Pages\n\nIn rare cases,\nyou may want to add extra pages to your workshop website.\nYou can do this by putting either Markdown or HTML pages in the website's root directory\nand styling them according to the instructions give in\n[the lesson template][lesson-example].\nIf you do this,\nyou *must* also edit `_config.yml` to set these three values:\n\n1.  `carpentry` is either \"dc\" (for Data Carpentry) or \"swc\" (for Software Carpentry).\n    This determines which logos are loaded.\n\n2.  `title` is the title of your workshop (typically the venue and date).\n\n3.  `email` is the contact email address for your workshop,\n    e.g., `gvwilson@miskatonic.edu`.\n\nNote: `carpentry and `email` duplicate information that's in `index.html`,\nbut there is no way to avoid this\nwithout requiring people to edit both files in the usual case\nwhere no extra pages are created.\n\n## Installing Software\n\nIf you want to set up Jekyll\nso that you can preview changes on your own machine before pushing them to GitHub,\nyou must install the software described below.\n(Note: Julian Thilo has written instructions for\n[installing Jekyll on Windows][jekyll-windows].)\n\n1.  **Ruby**.\n    This is included with Linux and Mac OS X;\n    the simplest option on Windows is to use [RubyInstaller][ruby-installer].\n    You can test your installation by running `ruby --version`.\n    For more information,\n    see [the Ruby installation guidelines][ruby-install-guide].\n\n2.  **[RubyGems][rubygems]**\n    (the package manager for Ruby).\n    You can test your installation by running `gem --version`.\n\n3.  **[Jekyll][jekyll]**.\n    You can install this by running `gem install jekyll`.\n\nYou can check the formatting of your header by running `bin/workshop_check.py`\n(which is invoked by `make workshop-check`).\nYou must have Python 3 installed in order to do this,\nand you will also need the [PyYAML][pyyaml] module.\n\n## Setting Up a Separate Repository for Learners\n\nIf you are teaching Git,\nyou should create a separate repository for learners to use in that lesson.\nYou should not have them use the workshop website repository because:\n\n*   your workshop website repository contains many files\n    that most learners don't need to see during the lesson,\n    and\n\n*   you probably don't want to accidentally merge\n    a damaging pull request from a novice Git user\n    into your workshop's website while you are using it to teach.\n\nYou can call this repository whatever you like,\nand add whatever content you need to it.\n\n## Getting and Giving Help\n\nWe are committed to offering a pleasant setup experience for our learners and organizers.\nIf you find bugs in our instructions,\nor would like to suggest improvements,\nplease [file an issue][issues]\nor [mail us][contact].\n\n[contact]: mailto:admin@software-carpentry.org\n[customization]: https://swcarpentry.github.io/workshop-template/customization/\n[dc-site]: http://datacarpentry.org\n[design]: https://swcarpentry.github.io/workshop-template/design/\n[faq]: https://swcarpentry.github.io/workshop-template/faq/\n[github-project-pages]: https://help.github.com/articles/creating-project-pages-manually/\n[importer]: http://import.github.com/new\n[issues]: https://github.com/swcarpentry/workshop-template/issues\n[jekyll]: https://jekyllrb.com/\n[jekyll-windows]: http://jekyll-windows.juthilo.com/\n[lesson-example]: https://swcarpentry.github.io/lesson-example/\n[pyyaml]: https://pypi.python.org/pypi/PyYAML\n[ruby-install-guide]: https://www.ruby-lang.org/en/downloads/\n[ruby-installer]: http://rubyinstaller.org/\n[rubygems]: https://rubygems.org/pages/download/\n[swc-site]: http://software-carpentry.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsdms%2Fworkshop-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcsdms%2Fworkshop-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsdms%2Fworkshop-template/lists"}