From mboxrd@z Thu Jan 1 00:00:00 1970 From: Karsten Schmidt Subject: Re: [ANN] thi.ng/org-spec template for tech specs & HTML export theme Date: Wed, 3 Aug 2016 12:00:23 +0100 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38787) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bUtuV-0007tS-7k for emacs-orgmode@gnu.org; Wed, 03 Aug 2016 07:00:28 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bUtuS-0001Qj-OB for emacs-orgmode@gnu.org; Wed, 03 Aug 2016 07:00:26 -0400 Received: from mail-io0-x22c.google.com ([2607:f8b0:4001:c06::22c]:33664) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bUtuS-0001QX-Jv for emacs-orgmode@gnu.org; Wed, 03 Aug 2016 07:00:24 -0400 Received: by mail-io0-x22c.google.com with SMTP id 38so239519055iol.0 for ; Wed, 03 Aug 2016 04:00:24 -0700 (PDT) In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Kaushal Modi Cc: emacs-orgmode@gnu.org Thanks Kaushal! :) I also think that we generally need more examples showing how flexible & powerful org-mode is for these use cases. The majority raves about Markdown, but for me it just lacks a ton of features I've become so accustomed to w/ org-mode, especially when it comes to writing and managing larger docs (i.e. the latest tech spec I've been working on is 9000+ words) and dozens of diagrams (all text based!) Re: PDF export - for me going the route via HTML is just easier & more time saving (can control important print features via a few lines of CSS). Plus I don't need to install 2.5GB of MacTex :) Also, the generated PDF looks same as HTML, has hyperlinks etc. Haven't tried w/ MathJax yet, though... Expect a few more updates over the coming weeks: - move to SASS for style sheets, for easier re-skinning via variables - improve TOC - add back-to-top links - add more diagram examples (incl. data extraction from tables) - add optional support for highlight.js Cheers! On 1 August 2016 at 23:35, Kaushal Modi wrote: > On Sun, Jul 31, 2016 at 8:55 AM Karsten Schmidt wrote: >> >> >> To give a little back to this amazing group of people, I've just >> published a skeleton template for writing tech docs and publishing >> them as HTML. >> >> GH project: http://thi.ng/org-spec >> Demo: http://demo.thi.ng/org-spec > > > Thanks Karsten! I had a look through those and it looks awesome! I think > they serve as very good examples in general on how to use org for technical > documentation. > > I yet have to try out printing PDF from the browser using your style.css. I > generally rely on the org exporter to generate both HTML and PDF. What > limitations did you face when using the org latex exporter for generating > the PDF? > -- > > Kaushal Modi -- Karsten Schmidt http://postspectacular.com | http://thi.ng | http://toxiclibs.org