From mboxrd@z Thu Jan 1 00:00:00 1970 From: Justin Gordon Subject: Excited to Join and Questions Date: Sun, 24 Nov 2013 13:14:16 -1000 Message-ID: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=089e013cba6237457f04ebf46901 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:37069) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vkisx-0002H2-MA for emacs-orgmode@gnu.org; Sun, 24 Nov 2013 18:14:41 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vkisv-00057D-Ju for emacs-orgmode@gnu.org; Sun, 24 Nov 2013 18:14:39 -0500 Received: from mail-oa0-x232.google.com ([2607:f8b0:4003:c02::232]:46482) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vkisv-000579-Ck for emacs-orgmode@gnu.org; Sun, 24 Nov 2013 18:14:37 -0500 Received: by mail-oa0-f50.google.com with SMTP id n16so3581746oag.37 for ; Sun, 24 Nov 2013 15:14:36 -0800 (PST) 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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org --089e013cba6237457f04ebf46901 Content-Type: text/plain; charset=ISO-8859-1 Greetings fellow org-mode aficionados! First, a big thanks to all that contributed to the project. It's one of my all-time favorite tools. I write to you all as I'm looking for advice on help as I upgrade my blog publishing system from the older org-mode to the current 8.x architecture. I wrote a detailed summary of how I did this with 7.8 org-mode here: http://www.railsonmaui.com/blog/2013/04/27/octopress-setup-with-github-and-org-mode/ That system depended on the old exporter and output HTML, rather than markdown. I looked into the org-octopress plugin, but that's not meeting my needs mostly because the HTML export is not formatting my old org files as I'd like them to. So, I'm trying to write an extension of ox-md.el that supports extended markdown dialects, such as kramdown and rdiscount. I took the output from ox-md.el, and I have a small list of changes I need to make for the output. Nicolas as offered me some tips, and suggested I write to the group so all can benefite. So here's my grand list of questions: Strategy ------------------- What is the right approach for getting dot-org files into Octopress? Octopress wants Markdown, but Markdown can have embedded HTML: http://daringfireball.net/projects/markdown/syntax#html The key consideration is that there must be a blank line before and after the block-level HTML block (div, table, pre, p, etc.) in Markdown. I'd like to make it as easy as possible to support liquid templates, as that's a key part of Octopress. What's the least maintenance in the long run? What's simplest? I'm guessing that Markdown conversion for the basic syntax with a fallback to HTML for lesser supported org-elements. Debugging and Development Tips for Org-Mode? ------------------------------------------------------------------------ 1. What are the best links with development advice? 2. What's the best workflow for developing a new exporter? For example, I've got a small test file that demonstrates the formatting change I'm trying to implement. I compile my ox-md-ext.el file for edebug mode, and then I run the code, checking the output and maybe debugging. 3. Related to #2, is there any example of tests that verify the conversion of input files into output files? Like could I create a few examples of org code and create some examples of the expected octopress enabled markdown that should be generated? Code is where? ----------------------- Where is the code that formats lines to say 80 chars in the ox-md conversion? It's breaking up markdown link text with \n. Thanks in advance for any advice. Justin Gordon www.railsonmaui.com | twitter: @railsonmaui | sugarranchmaui.com | Sugar Ranch Blog --089e013cba6237457f04ebf46901 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable
Greetings fellow org-mode aficionados! First, a big t= hanks to all that contributed to the project. It's one of my all-time f= avorite tools.

I write to you all as I'm looki= ng for advice on help as I upgrade my blog publishing system from the older= org-mode to the current 8.x architecture. I wrote a detailed summary of ho= w I did this with 7.8 org-mode here:=A0http://www.railsonmaui.com/blog/2013/04/27/octopress-setup-with-github-= and-org-mode/

That system depended on the old exporter and output HTM= L, rather than markdown.

I looked into the org-oct= opress plugin, but that's not meeting my needs mostly because the HTML = export is not formatting my old org files as I'd like them to.

So, I'm trying to write an extension of ox-md.el th= at supports extended markdown dialects, such as kramdown and rdiscount.

I took the output from ox-md.el, and I have a small l= ist of changes I need to make for the output. Nicolas as offered me some ti= ps, and suggested I write to the group so all can benefite.

So here's my grand list of questions:
Strategy
-------------------
What is the ri= ght approach for getting dot-org files into Octopress? Octopress wants Mark= down, but Markdown can have embedded HTML:=A0http://daringfireba= ll.net/projects/markdown/syntax#html
The key consideration is that there must be a blank line before and af= ter the block-level HTML block (div, table, pre, p, etc.) in Markdown. I= 9;d like to make it as easy as possible to support liquid templates, as tha= t's a key part of Octopress. What's the least maintenance in the lo= ng run? What's simplest? I'm guessing that Markdown conversion for = the basic syntax with a fallback to HTML for lesser supported org-elements.=

Debugging and Development Tips for Org-Mode?
= ------------------------------------------------------------------------
1. What are the best links with development advice?
2. What's the best workflow for developing a new exporter? For example,= I've got a small test file that demonstrates the formatting change I&#= 39;m trying to implement. I compile my ox-md-ext.el file for edebug mode, a= nd then I run the code, checking the output and maybe debugging.
3. Related to #2, is there any example of tests that verify the conver= sion of input files into output files? Like could I create a few examples o= f org code and create some examples of the expected octopress enabled markd= own that should be generated?

Code is where?
-----------------------
<= div>Where is the code that formats lines to say 80 chars in the ox-md conve= rsion? It's breaking up markdown link text with \n.

Thanks in advance for any advice.

--089e013cba6237457f04ebf46901--