X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=2019%2FREADME.md;h=2b2b2b1868ad679ee86446fd361dfa22acc3ff11;hb=2753d7038370e172af017647b34156bdb929ff64;hp=20082ff938b4706a90d468b76da8355c6e24a71e;hpb=d4eb563b0f8645df07d460fa45d8a5fe1b68adab;p=libreplanet-static.git diff --git a/2019/README.md b/2019/README.md index 20082ff9..2b2b2b18 100644 --- a/2019/README.md +++ b/2019/README.md @@ -4,7 +4,7 @@ Heads up: to edit the Web site, you'll need a basic-to-intermediate understandin # SECTION 1: DEVELOPMENT WORKFLOW -The actual LIVE site, visible at libreplanet.org/YEAR, is served from the "stable" branch of the git repository using a git hook. There is also a development branch called "master" which we use to preview edits on the Web. The master branch is served to the Web at http://wiki-dev0.libreplanet.org/YEAR and publicly visible, but not linked to. +The actual LIVE site, visible at libreplanet.org/YEAR, is served from the "stable" branch of the git repository using a git hook. There is also a development branch called "master" which we use to preview edits on the Web. The master branch **used to** be served to the Web at http://wiki-dev0.libreplanet.org/YEAR and publicly visible, but not linked to. Full workflow to make, test and deploy an edit. ----------------- @@ -45,7 +45,7 @@ Here are specific instructions for more complex editing tasks: The workflow for this is Edit the Brains page with the schedule, then run a script to convert it into HTML and dump it into your checkout of the repo, then push that change up to the Web like any other edit. -See instructions at for installing and running the script. The source files are stored in Brains in markdown but with special tags, so that you can edit them without needing to know this whole process. The jinja2 templates are stored in the the Web site's git repo at assets/templates. +See instructions at for installing and running the script. The source files are stored in Brains in markdown but with special tags, so that you can edit them without needing to know this whole process. Please crop all photos of speakers too 100x100 px (200x200 px for keynotes) and then upload them to . Then include their URL in the bios page to embed them. @@ -88,6 +88,10 @@ chmod +x foo.html Replace `foo.html` with the desired file name. +## Using Markdown + +Static pages can be edited using markdown by creating a index.mdwn file in the appropriate subdirectory (e.g. ./fun/index.mdwn) and running 'make wikipages'. Note that the .mdwn files should have the ```