<div><div dir="auto">Dear Sherif, interesting, will look into these too, thanks!)</div><div dir="auto">Timur</div><br><div class="gmail_quote"><div dir="ltr">On Sun, 5 Aug 2018 at 01:03, Sherif Mansour <<a href="mailto:sherif.mansour@owasp.org">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>Hi Timur,</div><div><br></div><div>A standard, maintained md CSS is what the current thinking is, so we are in allignment there - I would stress it should be optional for the community to use, but will be there if the needed it.</div><div>Looking a bit deeper I fournd the following:</div><div><ul><li><a href="http://friendsofepub.github.io/Blitz/" target="_blank">http://friendsofepub.github.io/Blitz/</a></li><li><a href="http://bbebooksthailand.com/bb-CSS-boilerplate.html" target="_blank">http://bbebooksthailand.com/bb-CSS-boilerplate.html</a></li></ul><div>Thanks again,</div><div>-Sherif<br></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Aug 4, 2018 at 11:42 PM, Timur 'x' Khrotko [owasp] <span dir="ltr"><<a href="mailto:timur@owasp.org" target="_blank">timur@owasp.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div dir="auto">Offtopic: especially the use of printed guides is doubtful, so I suggest not to make that a priority format/output -- that's an important frame requirement when you make choices about CSS. My experience is that if you made a pole then most of our colleagues would say guides are useless devices when it comes to help developers in their practices. Noone reads guides, instead they check stackoverflow for guidance. So we have to create one click away guidelines competing with the sof articles. </div></div><div dir="auto"><br></div><div dir="auto">Using Ms doc to create stylesheets you mean!? Any and all word processors create horrible HTML and CSS. </div><div dir="auto"><br></div><div dir="auto">What I suggested aims to use clean, maintainable and reusable (for different media) CSS. So that I suggested to use a combo: take a standard, maintained md CSS, add your own look on top of it.</div><div dir="auto"><br></div><div dir="auto">If OWASP had a professionally designed standard document template I could make you a CSS with that look. Have we? (Or the document design case is like with the new site design, a doomed goal ))</div><div dir="auto"><br></div><div dir="auto">Timur</div><div class="m_-6618256308335739733HOEnZb"><div class="m_-6618256308335739733h5"><div><br><div class="gmail_quote"><div dir="ltr">On Sun, 5 Aug 2018 at 00:15, 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>Thanks Timur,</div><ul><li>So far in my research I got a makefile and have been able to publish from MD to html/epub/PDF - (PDFs are useful to print physical copies of books).</li><li><a href="https://github.com/kerberosmansour/OWASP-Books/tree/master/OWASPBooks/InProgress/SAMM/v1.5" target="_blank">https://github.com/kerberosmansour/OWASP-Books/tree/master/OWASPBooks/InProgress/SAMM/v1.5</a> - this is the example for SAMM - note epub/HTML/PDF artifcats <br></li></ul><div>so we have a process, but my challenge is on the design side and would like some help there to produce a template for all OWASP to use (both CSS & Latex) - I heard some have used MS Doc for style but I am not familiar with that process.</div></div><div dir="ltr"><div><br></div><div>-Sherif<br></div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Aug 4, 2018 at 10:40 PM, Timur 'x' Khrotko [owasp] <span dir="ltr"><<a href="mailto:timur@owasp.org" target="_blank">timur@owasp.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><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><div class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302h5"><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></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302h5"><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_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_5997216124087783939m_1629884905062143961gmail-il">OWASP</span> has a lot of <span class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_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_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_5997216124087783939m_1629884905062143961gmail-il">books</span>?</b><br></u></div><div>Currently we have one <span class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_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_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_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_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_5997216124087783939m_1629884905062143961gmail-il">OWASP</span>/samm/blob/master/v1.5/MarkDown/<span class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_5997216124087783939m_1629884905062143961gmail-il">Owasp</span>-<span class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_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_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_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_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_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_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_5997216124087783939m_1629884905062143961gmail-il">book</span>-template</a></li><li>Format the <span class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_5997216124087783939m_1629884905062143961gmail-il">book</span> to look "cleaner" and ready for publishing (the <span class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_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_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_5997216124087783939m_1629884905062143961gmail-il">book</span> design/format would help the foundation greatly. <br></div><br clear="all"><br>-- <br><div class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475m_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></div><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><span>_______________________________________________<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>
</span></blockquote></div></div><span class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302HOEnZb"><font color="#888888">
</font></span></div><span class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302HOEnZb"><font color="#888888">-- <br><div dir="ltr" class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302m_7039131600090594475gmail_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>
</font></span></blockquote></div><br><br clear="all"><br>-- <br><div class="m_-6618256308335739733m_-7670882260871282067m_-5720105059248677302gmail_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></blockquote></div></div></div></div><span class="m_-6618256308335739733HOEnZb"><font color="#888888">-- <br><div dir="ltr" class="m_-6618256308335739733m_-7670882260871282067gmail_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>
</font></span></blockquote></div><br><br clear="all"><br>-- <br><div class="m_-6618256308335739733gmail_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></blockquote></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>