From: Juan Reyero <joanmg@gmail.com>
To: Waldemar Quevedo <waldemar.quevedo@gmail.com>
Cc: org-mode Mailing List <emacs-orgmode@gnu.org>
Subject: Re: Writing your book with orgmode and publishing it on Leanpub
Date: Mon, 24 Feb 2014 09:33:54 +0100 [thread overview]
Message-ID: <CAKSxNJjA7-fqVwS72LwpreJ32U-oSRQYbtjS3PZJ5S4sdkDH2Q@mail.gmail.com> (raw)
In-Reply-To: <CALzn4yiFQ1feS6b9FJDG-kgx-HaoiuKPagC1E25GNcRt73QFtQ@mail.gmail.com>
On Mon, Feb 24, 2014 at 8:39 AM, Waldemar Quevedo
<waldemar.quevedo@gmail.com> wrote:
>> It is rather annoying that github understands the org syntax but not
>> quite, so the sources appear almost but not quite right.
> I maintain the parser that is being by Github =>
> https://github.com/wallyqs/org-ruby
> If you let me now the issues I can try to fix them, (or PRs are also
> welcome)....
Sorry I sounded dismissive. You are doing an awesome job, it's
amazing how much it did get right.
My problem is that I am trying to share my sources as code, not as
documentation. I would like my .org files to be treated as you would
treat Python code, shown as they are and syntax-highlighted. If you
parse them you will inevitably miss the context I am relying upon to
render them properly (like when you ---rightly--- assume that html
should be left standing, but what I wrote expects a jekyll
post-process).
People visiting the repository will most likely be interested in what
I actually wrote, not in its rendering as a document. Close to what
you get when you select Raw, but syntax-highlighted. This is what I
want the repository for; the document is somewhere else.
That said, the one place where the translation fails is when the
source code of babel snippets should not be exported. Again, probably
due to the tension between the need to show the file's content and the
desire to render it as a document.
> I have this example
> where you can use `#+layout:` instead of YAML.
> https://github.com/wallyqs/yet-another-jekyll-org-template
> https://github.com/eggcaker/jekyll-org/blob/master/convert.rb#L30
Thank you for the pointer.
Best,
jm
> On Mon, Feb 24, 2014 at 4:24 AM, Juan Reyero <joanmg@gmail.com> wrote:
>>
>> Greetings,
>>
>> I've solved a couple of bugs in the Leanpub[1] markdown exporter[2]
>> (cross-links within the book using ids were not working, and footnotes
>> containing a colon neither). As far as I can tell using Orgmode and
>> Leanpub to publish books is now quite feasible, and produces rather
>> nice results.
>>
>> I have also published the sources for my book, The Hacker Ways[3], at
>>
>> https://github.com/juanre/hacker-ways
>>
>> It is rather annoying that github understands the org syntax but not
>> quite, so the sources appear almost but not quite right. Clone and
>> open in Emacs to see what's going on.
>>
>> Best regards,
>>
>> jm
>> --
>> http://greaterskies.com
>> http://juanreyero.com
>>
>> [1] Leanpub.com is a very nice self-publishing platform. I am not
>> associated with them, and they are not responsible for my code.
>>
>> [2] http://juanreyero.com/open/ox-leanpub/
>>
>> [3] https://leanpub.com/hackerways/
>>
>
--
http://greaterskies.com
http://juanreyero.com
next prev parent reply other threads:[~2014-02-24 8:33 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-02-23 19:24 Writing your book with orgmode and publishing it on Leanpub Juan Reyero
2014-02-24 7:39 ` Waldemar Quevedo
2014-02-24 8:33 ` Juan Reyero [this message]
2014-02-24 12:26 ` Waldemar Quevedo
2014-02-24 9:23 ` Sebastien Vauban
2014-02-24 12:08 ` Waldemar Quevedo
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAKSxNJjA7-fqVwS72LwpreJ32U-oSRQYbtjS3PZJ5S4sdkDH2Q@mail.gmail.com \
--to=joanmg@gmail.com \
--cc=emacs-orgmode@gnu.org \
--cc=waldemar.quevedo@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).