From 634104440aaa0cdf217f7bdc612980fe9b889e9c Mon Sep 17 00:00:00 2001 From: rsiddharth Date: Sun, 7 Feb 2016 15:41:38 -0500 Subject: README.rst: Added LP speakers section. It contains relevant documentation pertaining to LP speakers. Addresses issue #1. --- README.rst | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) (limited to 'README.rst') diff --git a/README.rst b/README.rst index 744a32a..3d1ac96 100644 --- a/README.rst +++ b/README.rst @@ -144,6 +144,77 @@ beginning of the markdown document: Sessions only sample: https://notabug.org/rsd/lpschedule-generator/raw/dev/tests/files/lp-sch-sessions-only.md +LP speakers +----------- + +LP speakers usage +~~~~~~~~~~~~~~~~~ +:: + + $ lps_gen -sp path/to/lp-speakers-2016.jinja2 path/to/lp-speakers.md > path/to/speakers-content.html + +or:: + + $ lps_gen --speakers path/to/lp-speakers-2016.jinja2 path/to/lp-speakers.md > path/to/speakers-content.html + +LP speakers markdown structure +`````````````````````````````` + +:: + + # Keynote speaker name 1 + + ![Keynote speaker name 1 - Photo](//fsf.org/images/ks1.jpg) + + Lorem ipsum dolor sit amet keynote speaker 1 bio; can contain + inline HTML. + + # Keynote speaker name 2 + + ![Keynote speaker name 2 - Photo](//fsf.org/images/ks2.jpg) + + Lorem ipsum dolor sit amet keynote speaker 2 bio; can contain + inline HTML. + + ... + + ## Speaker name 1 + + ![Speaker name 1 - Photo](//fsf.org/images/s1.jpg) + + Lorem ipsum dolor sit amet speaker 1 bio; can contain inline HTML. + + ## Speaker name 2 + + ![Speaker name 2 - Photo](//fsf.org/images/s2.jpg) + + Lorem ipsum dolor sit amet speaker 2 bio; can contain inline HTML. + + ... + + +Everything except the speaker name is optional. + +Sample: https://notabug.org/rsd/lpschedule-generator/raw/dev/tests/files/lp-speakers.md + +Speaker's ID generation ++++++++++++++++++++++++ + +The last name of the speaker is automatically made the ID; if a +speaker' name is "John Hacker", the ID for this speaker will be +``hacker``. + + - If two or more speakers have the same last name, then, the first + speaker will have their last name as their ID and from the second + to the nth speaker will have their full name as their + ID; if "Bill Hacker" and "Jill Hacker" are two speakers, "Bill" + will get ``hacker`` as his ID and "Jill" will get ``jill_hacker`` + as her ID. + + - The IDs are transliterated to ASCII; if a speaker' name is "John + HÖcker", the ID for this speaker will be ``hacker``. + + Source ------ -- cgit v1.2.3