From mboxrd@z Thu Jan  1 00:00:00 1970
From: Thierry Banel <tbanelwebmin@free.fr>
Subject: single file export in HTML (as easy as PDF) (well, almost)
Date: Sun, 23 Oct 2016 19:26:29 +0200
Message-ID: <580CF2C5.2020103@free.fr>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:45875)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <tbanelwebmin@free.fr>) id 1byMXd-0005Xn-BD
	for emacs-orgmode@gnu.org; Sun, 23 Oct 2016 13:26:38 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <tbanelwebmin@free.fr>) id 1byMXa-0002u2-5I
	for emacs-orgmode@gnu.org; Sun, 23 Oct 2016 13:26:37 -0400
Received: from smtp5-g21.free.fr ([212.27.42.5]:37187)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <tbanelwebmin@free.fr>)
	id 1byMXZ-0002tm-Tg
	for emacs-orgmode@gnu.org; Sun, 23 Oct 2016 13:26:34 -0400
Received: from [IPv6:2a01:e35:2e21:def0:3c4a:5e88:5115:2ed4] (unknown
	[IPv6:2a01:e35:2e21:def0:3c4a:5e88:5115:2ed4])
	by smtp5-g21.free.fr (Postfix) with ESMTP id B1A875FE84
	for <emacs-orgmode@gnu.org>; Sun, 23 Oct 2016 19:26:29 +0200 (CEST)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: emacs-orgmode@gnu.org

A single, nicely packaged, PDF file, easy to distribute:this is one of
the appealing features of PDF export.

But actually, this can be achieved in HTML, out-of-the-box with Org Mode
and Firefox.

My recipe:

- Write your book in Org Mode, with any content you want:
  + tables, headers, bullet lists, whatever
  + PNG or SVG images (file:myimage.svg)
  + Ditaa    (#+begin_src ditaa :file myditaa.png)
  + Gnuplot  (#+begin_src gnuplot :file mygnuplot.svg)
  + GraphViz (#+begin_src dot :file mygraphviz.png)
  + MathJax  (#+html_mathjax: align: left) ($$\sqrt{x+1}$$)

- Add HTML formatting (optional)
  + CSS to customize fonts, colors, sizes, layout
    (#+html:<link rel="stylesheet" href="my.css"/>)
  + InfoJS to expand-collapse in the browser as in Org Mode
    (#+infojs_opt: view:info toc:nil ...)

- Export & package to a single file
  + C-c C-e h h
  + zip the whole directory to mybook.zip
    (along with SVG, PNG images, CSS style-sheets, JS)

- Distribute your book
  + send mybook.zip to your friends and colleagues
  + ask them to point their Firefox to
    jar:file://mybook.zip!/mybook/mybook.html

The magic Firefox feature is the jar-bang trick which allows browsing
within a ZIP.

If someone knows a less cryptic syntax, it would be great.Also, this
trick only works in Firefox. Is there something similar in other browsers?

Have fun
TB