<div><div><div dir="auto">Hello, I work on a document pipeline of a similar sort: to prepare collaborative book/guide content in md (hosted on gitlab, or github, or/and in local gits), to compile the publications with pandoc and publish it online (for me the PDF books are secondary in their practical usefulness). We prepare a couple of such collaborative defdev publications: an ssdlc playbook and secure coding guides. </div><div dir="auto"><br></div><div dir="auto">I suggest using a standard 'css for md' css as base -- there are a number of such csses. You can dig a nice one from the internals of visual code for example. Or (as I do) you can start off the </div><div dir="auto"><div><a href="https://github.com/sindresorhus/github-markdown-css" target="_blank">https://github.com/sindresorhus/github-markdown-css</a></div><br></div><div dir="auto">Then you add your custom css next in the cascade. You need a designer for the latter only.</div></div></div><div><div><div dir="auto"><br></div><div dir="auto">Also in case of a book your source is not a monolithic md but pieces which you have to concatenate before feeding to pandoc. And you can hit a couple of the md weaknesses, like line breaks which working your editors are not expected to learn.</div><div dir="auto"><br></div><div dir="auto">Let me know if I can help with some particular issues.</div><div dir="auto"><br></div><div dir="auto">Timur</div><div dir="auto"><br></div><br><div class="gmail_quote"><div dir="ltr">On Sat, 4 Aug 2018 at 15:14, Sherif Mansour <<a href="mailto:sherif.mansour@owasp.org" target="_blank">sherif.mansour@owasp.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Hey Gang<br></div><div><br></div><div>Now that AppsecEU is behind us, I need some small web design help on the owasp books project, if 
you know a web desinger or would like to help it would be much 
appreciated. <br></div><div><br></div><div>The idea is to provide the various OWASP document projects with a template and a service to publish their documents in various formats - when they so choose.<br></div><div><br></div><div>Basically <span class="m_5997216124087783939m_1629884905062143961gmail-il">OWASP</span> has a lot of <span class="m_5997216124087783939m_1629884905062143961gmail-il">books</span>
 in various formats. We want provide a service to document projects to move them to MarkDown format and from 
there we can use a tool called pandocs to export them to any format 
(PDF/Ebooks/physical books etc..). That way we can update them easily and publish them 
on amazon etc..</div><div><br></div><div>We have already helped the SAMM project convert their PDF of version 1.5 into Mark Down. We need to produce a nice design template (CSS) for projects to use if they want.<br></div><div><br></div><div><u><b>Where are the <span class="m_5997216124087783939m_1629884905062143961gmail-il">books</span>?</b><br></u></div><div>Currently we have one <span class="m_5997216124087783939m_1629884905062143961gmail-il">book</span>: The SAMM ebook can be found here (this includes the images, and mobi/epub formats):</div><div><a href="https://github.com/OWASP/samm/tree/master/v1.5/MarkDown" target="_blank">https://github.com/<span class="m_5997216124087783939m_1629884905062143961gmail-il">OWASP</span>/samm/tree/master/v1.5/MarkDown</a> <br></div><div><br></div><div>The basic instructions on how to convert a md file to an ebook can be found here:<br></div><div><a href="https://github.com/OWASP/samm/blob/master/v1.5/MarkDown/Owasp-Books.md" target="_blank">https://github.com/<span class="m_5997216124087783939m_1629884905062143961gmail-il">OWASP</span>/samm/blob/master/v1.5/MarkDown/<span class="m_5997216124087783939m_1629884905062143961gmail-il">Owasp</span>-<span class="m_5997216124087783939m_1629884905062143961gmail-il">Books</span>.md</a></div><div><br></div><div>However it doesn't look great. Now pandocs has actually a template to show how it's done properly here:</div><div><a href="https://github.com/wikiti/pandoc-book-template" target="_blank">https://github.com/wikiti/pandoc-<span class="m_5997216124087783939m_1629884905062143961gmail-il">book</span>-template</a></div><div><br></div><div><u><b>What is the ask:<br></b></u></div><div><ul><li>Take the contents of the current MD formated <span class="m_5997216124087783939m_1629884905062143961gmail-il">book</span> (<a href="https://github.com/OWASP/samm/tree/master/v1.5/MarkDown" target="_blank">see link</a>).</li><li>Go through the pandoc guide here: <a href="https://github.com/wikiti/pandoc-book-template" target="_blank">https://github.com/wikiti/pandoc-<span class="m_5997216124087783939m_1629884905062143961gmail-il">book</span>-template</a></li><li>Format the <span class="m_5997216124087783939m_1629884905062143961gmail-il">book</span> to look "cleaner" and ready for publishing (the <span class="m_5997216124087783939m_1629884905062143961gmail-il">book</span> can take a CSS as well like in the guide above).<br></li></ul></div><div><u><b>What is the plan next?</b></u></div><div>Please reach out to me, we have many documents and we 
want to ensure they are updated regularly so a default <span class="m_5997216124087783939m_1629884905062143961gmail-il">book</span> design/format would help the foundation greatly. <br></div><br clear="all"><br>-- <br><div class="m_5997216124087783939m_1629884905062143961gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><pre cols="72" style="white-space:pre-wrap;color:rgb(136,136,136)"><pre cols="72" style="white-space:pre-wrap">Sherif Mansour
OWASP Global Board Member & OWASP London Chapter Leader <br>Site: <a href="https://www.owasp.org/index.php/London" style="color:rgb(17,85,204)" target="_blank">https://www.owasp.org/index.php/London</a><br>Email: <a href="mailto:sherif.mansour@owasp.org" style="color:rgb(17,85,204)" target="_blank">sherif.mansour@owasp.org </a>
Follow OWASP London Chapter on Twitter: <a href="https://twitter.com/OWASPLondon" target="_blank">@owasplondon </a>
"Like" us on Facebook: <a href="https://www.facebook.com/OWASPLondon" style="color:rgb(17,85,204)" target="_blank">https://www.facebook.com/OWASPLondon</a>
Subscribe to our (lightweight) mailing list: <a href="https://lists.owasp.org/mailman/listinfo/owasp-london" style="color:rgb(17,85,204)" target="_blank">https://lists.owasp.org/mailman/listinfo/owasp-london</a> <br><span><div><br></div></span></pre></pre><div><span><p style="color:rgb(136,136,136);font-size:12.8px">Consider giving back, and supporting the open source community by becoming a <a href="https://www.owasp.org/index.php/Membership" style="color:rgb(17,85,204)" target="_blank">member</a> or making a <a href="https://www.owasp.org/index.php/Donate" style="color:rgb(17,85,204)" target="_blank">donation</a> today!</p></span><p style="color:rgb(136,136,136);font-size:12.8px"><img src="https://drive.google.com/a/owasp.org/uc?id=0Bzb3QwFMHCXrd1J2WkI3Z3k5Zk1zM2NNc1ptdXFpNFhLYzBv&export=download"><span><br>Join us at <a href="https://2018.appsecusa.org/" style="color:rgb(17,85,204)" target="_blank">AppSec USA 2018</a> <span><span>8-12 October</span></span> in San Jose, CA!</span></p></div></div></div></div></div>
</div>

<br>
<div><span style="color:rgb(102,204,204);font-family:'times new roman',serif;font-size:x-small;background-color:rgb(255,255,255)">This message may contain confidential information - you should handle it accordingly.</span></div>_______________________________________________<br>
OWASP-Leaders mailing list<br>
<a href="mailto:OWASP-Leaders@lists.owasp.org" target="_blank">OWASP-Leaders@lists.owasp.org</a><br>
<a href="https://lists.owasp.org/mailman/listinfo/owasp-leaders" rel="noreferrer" target="_blank">https://lists.owasp.org/mailman/listinfo/owasp-leaders</a><br>
</blockquote></div></div>
</div>-- <br><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div dir="ltr"><div><font color="#999999">   </font></div><div><font color="#999999">secmachine․net</font><font color="#999999"> #wepowersecdev</font></div></div></div></div>