X-Git-Url: https://git.arvados.org/rnaseq-cwl-training.git/blobdiff_plain/503cdddb563604d04b3b1a2c9f23f30bed6e3dc5..47bfe1bdb97f7925ace52ed71aa93ba828c709f7:/bin/lesson_initialize.py diff --git a/bin/lesson_initialize.py b/bin/lesson_initialize.py index 0398d45..6e91826 100755 --- a/bin/lesson_initialize.py +++ b/bin/lesson_initialize.py @@ -3,10 +3,10 @@ """Initialize a newly-created repository.""" +from __future__ import print_function import sys import os - ROOT_AUTHORS = '''\ FIXME: list authors' names and email addresses. ''' @@ -63,18 +63,22 @@ and to meet some of our community members. ## Where to Contribute -1. If you wish to change this example lesson, - please work in . - This lesson documents the format of our lessons, +1. If you wish to change this lesson, + please work in , + which can be viewed at . + +2. If you wish to change the example lesson, + please work in , + which documents the format of our lessons and can be viewed at . -2. If you wish to change the template used for workshop websites, +3. If you wish to change the template used for workshop websites, please work in . The home page of that repository explains how to set up workshop websites, while the extra pages in provide more background on our design choices. -3. If you wish to change CSS style files, tools, +4. If you wish to change CSS style files, tools, or HTML boilerplate for lessons or workshops stored in `_includes` or `_layouts`, please work in . @@ -154,13 +158,12 @@ You can also [reach us by email][contact]. [dc-lessons]: http://datacarpentry.org/lessons/ [dc-site]: http://datacarpentry.org/ [discuss-list]: http://lists.software-carpentry.org/listinfo/discuss -[example-site]: https://swcarpentry.github.io/lesson-example/ [github]: http://github.com [github-flow]: https://guides.github.com/introduction/flow/ [github-join]: https://github.com/join [how-contribute]: https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github -[issues]: https://github.com/swcarpentry/lesson-example/issues/ -[repo]: https://github.com/swcarpentry/lesson-example/ +[issues]: https://github.com/swcarpentry/FIXME/issues/ +[repo]: https://github.com/swcarpentry/FIXME/ [swc-issues]: https://github.com/issues?q=user%3Aswcarpentry [swc-lessons]: http://software-carpentry.org/lessons/ [swc-site]: http://software-carpentry.org/ @@ -171,60 +174,63 @@ ROOT_CONFIG_YML = '''\ # Values for this lesson. #------------------------------------------------------------ -# Which carpentry is this ("swc" or "dc")? +# Which carpentry is this ("swc", "dc", or "lc")? carpentry: "swc" -# What kind of thing is this ("workshop" or "lesson")? -kind: "lesson" - # Overall title for pages. title: "Lesson Title" -# Repository URL (without trailing slash). -repo: https://github.com/[USERNAME]/[LESSON-SLUG] - -# Root URL below username.github.io domain, with leading slash but no trailing slash. -# For example, for 'https://swcarpentry.github.io/lesson-example', use '/lesson-example'. -root: "/[LESSON-SLUG]" - -# Contact email address. -email: "[[CONTACT-ADDRESS]]" +# Contact. This *must* include the protocol: if it's an email +# address, it must look like "mailto:lessons@software-carpentry.org", +# or if it's a URL, "https://gitter.im/username/ProjectName". +contact: "mailto:lessons@software-carpentry.org" #------------------------------------------------------------ # Generic settings (should not need to change). #------------------------------------------------------------ -# Is this production or development? (Overridden in _config_dev.yml.) -is_production: true +# What kind of thing is this ("workshop" or "lesson")? +kind: "lesson" + +# Magic to make URLs resolve both locally and on GitHub. +# See https://help.github.com/articles/repository-metadata-on-github-pages/. +repository: / # Sites. amy_site: "https://amy.software-carpentry.org/workshops" -dc_site: "https://datacarpentry.org" +dc_site: "http://datacarpentry.org" swc_github: "https://github.com/swcarpentry" swc_site: "https://software-carpentry.org" +swc_pages: "https://swcarpentry.github.io" +lc_site: "http://librarycarpentry.github.io/" template_repo: "https://github.com/swcarpentry/styles" example_repo: "https://github.com/swcarpentry/lesson-example" example_site: "https://swcarpentry.github.com/lesson-example" workshop_repo: "https://github.com/swcarpentry/workshop-template" workshop_site: "https://swcarpentry.github.io/workshop-template" +training_site: "https://swcarpentry.github.io/instructor-training" # Surveys. pre_survey: "https://www.surveymonkey.com/r/swc_pre_workshop_v1?workshop_id=" post_survey: "https://www.surveymonkey.com/r/swc_post_workshop_v1?workshop_id=" +training_post_survey: "https://www.surveymonkey.com/r/post-instructor-training" -# Start time in minutes (540 is 09:00 am) -start_time: 540 +# Start time in minutes (0 to be clock-independent, 540 to show a start at 09:00 am). +start_time: 0 # Specify that things in the episodes collection should be output. collections: episodes: output: true - permalink: /:path/ + permalink: /:path/index.html extras: output: true + permalink: /:path/index.html # Set the default layout for things in the episodes collection. defaults: + - values: + root: .. - scope: path: "" type: episodes @@ -243,6 +249,8 @@ highlighter: false ROOT_INDEX_MD = '''\ --- layout: lesson +root: . +permalink: index.html # Is the only page that don't follow the partner /:path/index.html --- FIXME: home page introduction @@ -255,7 +263,6 @@ FIXME: home page introduction ROOT_REFERENCE_MD = '''\ --- layout: reference -permalink: /reference/ --- ## Glossary @@ -267,11 +274,48 @@ ROOT_SETUP_MD = '''\ --- layout: page title: Setup -permalink: /setup/ --- FIXME ''' +ROOT_AIO_MD = '''\ +--- +layout: page +--- + +{% comment %} +Create anchor for each one of the episodes. +{% endcomment %} +{% for episode in site.episodes %} +
+{% endfor %} +''' + EPISODES_INTRODUCTION_MD = '''\ --- title: "Introduction" @@ -290,7 +334,6 @@ EXTRAS_ABOUT_MD = '''\ --- layout: page title: About -permalink: /about/ --- {% include carpentries.html %} ''' @@ -299,7 +342,6 @@ EXTRAS_DISCUSS_MD = '''\ --- layout: page title: Discussion -permalink: /discuss/ --- FIXME ''' @@ -308,24 +350,52 @@ EXTRAS_FIGURES_MD = '''\ --- layout: page title: Figures -permalink: /figures/ --- -{% include all_figures.html %} + +{% comment %} +Create anchor for each one of the episodes. +{% endcomment %} +{% for episode in site.episodes %} +
+{% endfor %} ''' EXTRAS_GUIDE_MD = '''\ --- layout: page -title: "Instructors' Guide" -permalink: /guide/ +title: "Instructor Notes" --- FIXME ''' -INCLUDES_ALL_FIGURES_HTML = '''\ - -''' - BOILERPLATE = ( ('AUTHORS', ROOT_AUTHORS), ('CITATION', ROOT_CITATION), @@ -334,12 +404,12 @@ BOILERPLATE = ( ('index.md', ROOT_INDEX_MD), ('reference.md', ROOT_REFERENCE_MD), ('setup.md', ROOT_SETUP_MD), + ('aio.md', ROOT_AIO_MD), ('_episodes/01-introduction.md', EPISODES_INTRODUCTION_MD), ('_extras/about.md', EXTRAS_ABOUT_MD), ('_extras/discuss.md', EXTRAS_DISCUSS_MD), ('_extras/figures.md', EXTRAS_FIGURES_MD), ('_extras/guide.md', EXTRAS_GUIDE_MD), - ('_includes/all_figures.html', INCLUDES_ALL_FIGURES_HTML) )