-in- parsing
In-Reply-To: <20101102202705.40da1634@noweto>
References: <20101101133906.GA18404@devielle>

	<20101102123600.7ddd1043@noweto>

	<20101102202705.40da1634@noweto>
Message-ID: <20110117094936.1a52c3f3@noweto>

On 2010-11-02 20:27 +0100 Thomas Leitner wrote:
> So I will classify this one as bug, too, and will fix it so that
> `` HTML elements will also be accounted for (as is done for the
> native code span syntax).

I have fixed this now. The rule for splitting a table row into cells is
now that all pipes are used except the ones that occur in native code
span elements (ie. using backticks) or HTML `` elements.

-- Thomas

From alex at noligy.de  Thu Jan 20 10:13:59 2011
From: alex at noligy.de (Alex Wall)
Date: Thu, 20 Jan 2011 16:13:59 +0100
Subject: [kramdown-users] kramdown syntax: strikeout,
	subscripts and superscripts
Message-ID: 

Hi, 

I think it would be nice if kramdown could also create strikeout, subscripts and superscripts. 

For compatibility reasons I would be the good to have the same syntax as pandoc has. 

Subscript:
H~2~O is a liquid.  

Superscript:
2^10^ is 1024. 

Strikeout:
This ~~is deleted text.~~

http://johnmacfarlane.net/pandoc/README.html#subscripts-and-superscripts

-- 
Salute Alex

From t_leitner at gmx.at  Thu Jan 20 15:27:07 2011
From: t_leitner at gmx.at (Thomas Leitner)
Date: Thu, 20 Jan 2011 21:27:07 +0100
Subject: [kramdown-users] kramdown syntax: strikeout,
 subscripts and superscripts
In-Reply-To: 
References: 
Message-ID: <20110120212707.71917c44@noweto>

On 2011-01-20 16:13 +0100 Alex Wall wrote:
> I think it would be nice if kramdown could also create strikeout,
> subscripts and superscripts. 
> 
> For compatibility reasons I would be the good to have the same syntax
> as pandoc has. 
> 
> Subscript:
> H~2~O is a liquid.  
> 
> Superscript:
> 2^10^ is 1024. 
> 
> Strikeout:
> This ~~is deleted text.~~

Since all three suggested syntaxes use characters currently not used by
kramdown, it would be okay for me to include them in kramdown. So, let's
start the discussion what the exact syntax would be like:

* Subscript

  Text parts surrounded by tilde characters are treated as subscript
  text. If the text part contains a whitespace character (space, tab,
  newline), it has to be escaped. Nesting of subscript text parts is
  not possible. Here are some examples:

      This is the formula for water: H~2~O.
      Another thing: P~w\ and\ v~ = 42

* Superscript

  Like subscript, but with the caret instead of the tilde

* Strikeout

  Like strong emphasis with asterisk

So: any opinions on (not) including the syntax?

Best regards,
  Thomas

From t_leitner at gmx.at  Sat Jan 22 02:52:49 2011
From: t_leitner at gmx.at (Thomas Leitner)
Date: Sat, 22 Jan 2011 08:52:49 +0100
Subject: [kramdown-users] [ANN] kramdown 0.13.1 released
Message-ID: <20110122085249.3fab0697@noweto>

## About kramdown

kramdown (sic, not Kramdown or KramDown, just kramdown) is a *free*
GPL-licensed [Ruby](http://www.ruby-lang.org) library for parsing a
superset of Markdown. It is completely written in Ruby, supports
standard Markdown (with some minor modifications) and various
extensions that have been made popular by the [PHP Markdown Extra]
package and [Maruku].

Homepage for installation instructions and documentation:
   http://kramdown.rubyforge.org

## kramdown 0.13.1 released

The focus of this release was bringing kramdown one step closer to the
1.0 release. The API hasn't changed, so this is a drop-in replacement
for the previous version of kramdown.

If you think that

* kramdown is still missing an important syntax found in another
  Markdown implementation,
* the API doesn't feel right,
* or anything else is missing or should be changed for the 1.0 release,

please tell us so by writing to !

## Changes

* 3 minor changs:

  - The LaTeX converter now inserts `\hypertarget` commands for all
    elements that have an ID set. The normal link syntax can be used to
    link to such targets (requested by David Doolin)
  - New option `smart_quotes` for specifying how smart quotes should be
    output (requested by Michael Franzl)
  - Any character except a closing bracket is now valid as link
    identifier (this makes this part of the kramdown syntax compatible
    to Markdown syntax)

* 10 bug fixes:

  - Fixed error when parsing unknown named entities (reported by David
    Doolin)
  - Added entity definitions for entities ` `, ` ` and
    ` ` (patch by Damien Pollet)
  - Block HTML line was incorrectly recognized as table line (reported
    by Piotr Szotkowski)
  - Fixed bug RF#28809: Empty `` tags are were output as self-closed
    tags (reported by Tim Cuthbertson)
  - Fixed bug RF#28785: Name of default template in documentation for
    `template` option was false (reported by Matthew Bennink)
  - Fixed bug RF#28769: span extension in list item wrongly triggered
    list item IAL parser (reported by Yann Esposito)
  - The table row parser has been fixed so that it does not use pipes
    which appear in `` tags as cell separators anymore (like it
    is done with the native code span syntax)
  - Fixed bug where converting `` and `` tags to native
    elements was wrongly done
  - Fixed calculation of cell alignment values when converting HTML
    tables to native ones, `` tags are now correctly used
  - HTML Tables are now only converted to native tables if all table
    rows have the same number of columns.

* 1 deprecation note:

  - Removed deprecated option `toc_depth` -- use the option
    `toc_levels` instead.

From alex at noligy.de  Mon Jan 24 17:35:42 2011
From: alex at noligy.de (Alex Wall)
Date: Mon, 24 Jan 2011 23:35:42 +0100
Subject: [kramdown-users] Feature Request: LaTeX Support in kramdown
Message-ID: 

Hi,

I know kramdown has support for latex math block, but when i use pure latex kramdown converts this 

\begin{figure}
   \includeicon{./Blume.pdf}
   \centering
   \caption{Konstruktionszeichnung der}
   \label{img:Bubble}
\end{figure}

to 

\textbackslash{}begin\{figure\}
   \textbackslash{}includeicon\{./Blume.pdf\}
   \textbackslash{}centering
   \textbackslash{}caption\{Konstruktionszeichnung der\}
   \textbackslash{}label\{img:Bubble\}
\textbackslash{}end\{figure\}

It would be nice if kramdown could handle markdown files more like pandoc. In pandoc it is possible to mix markdown and LaTeX as you like without any escape characters/sequences. 

This gives you the simplicity of markdown and the power of LaTeX when you really need it. 

Best Regards,

Alex Wall

From t_leitner at gmx.at  Thu Jan 27 05:28:17 2011
From: t_leitner at gmx.at (Thomas Leitner)
Date: Thu, 27 Jan 2011 11:28:17 +0100
Subject: [kramdown-users] Feature Request: LaTeX Support in kramdown
In-Reply-To: 
References: 
Message-ID: <20110127112817.0c1b28b4@noweto>

On 2011-01-24 23:35 +0100 Alex Wall wrote:
> It would be nice if kramdown could handle markdown files more like
> pandoc. In pandoc it is possible to mix markdown and LaTeX as you
> like without any escape characters/sequences. 
> 
> This gives you the simplicity of markdown and the power of LaTeX when
> you really need it. 

The reason why math support is done via LaTeX commands is that this is
supported by the HTML (via MathJax) and LaTeX converters. I'm sure that
if we add other converters there is a high probability that a solution
for converting LaTeX math commands to the specific output format is
available.

I don't think that supporting LaTeX commands directly in kramdown is a
good idea. The Markdown syntax is relatively easy to understand for
newcomers, LaTeX syntax is not. And most user would be surprised when
they see the resulting output. Another thing: what should be done with
LaTeX commands when converting a document to HTML? Leave them out?

If you really want to intersperse LaTeX commands with normal kramdown
syntax, I recommend using the `nomarkdown` extension!

Best regards,
  Thomas

From damien.pollet at gmail.com  Thu Jan 27 06:59:09 2011
From: damien.pollet at gmail.com (Damien Pollet)
Date: Thu, 27 Jan 2011 12:59:09 +0100
Subject: [kramdown-users] Feature Request: LaTeX Support in kramdown
In-Reply-To: <20110127112817.0c1b28b4@noweto>
References: 
	<20110127112817.0c1b28b4@noweto>
Message-ID: 

On Thu, Jan 27, 2011 at 11:28, Thomas Leitner  wrote:
> I don't think that supporting LaTeX commands directly in kramdown is a
> good idea. The Markdown syntax is relatively easy to understand for
> newcomers, LaTeX syntax is not. And most user would be surprised when
> they see the resulting output. Another thing: what should be done with
> LaTeX commands when converting a document to HTML? Leave them out?

Actually I'd love support for LaTeX blocks. In HTML they could be
rendered to images or small PDF files displayed inline. That would be
useful for scientific web pages that need complicated
notations/equations, or just LaTeX examples, but I agree, this is more
general than maths support; ideally that should allow for other
external processors, e.g. graphviz

-- 
Damien Pollet
type less, do more [ | ] http://people.untyped.org/damien.pollet

From t_leitner at gmx.at  Thu Jan 27 10:06:00 2011
From: t_leitner at gmx.at (Thomas Leitner)
Date: Thu, 27 Jan 2011 16:06:00 +0100
Subject: [kramdown-users] Feature Request: LaTeX Support in kramdown
In-Reply-To: 
References: 
	<20110127112817.0c1b28b4@noweto>

Message-ID: <20110127160600.5bcee069@noweto>

On 2011-01-27 12:59 +0100 Damien Pollet wrote:
> On Thu, Jan 27, 2011 at 11:28, Thomas Leitner 
> wrote:
> > I don't think that supporting LaTeX commands directly in kramdown
> > is a good idea. The Markdown syntax is relatively easy to
> > understand for newcomers, LaTeX syntax is not. And most user would
> > be surprised when they see the resulting output. Another thing:
> > what should be done with LaTeX commands when converting a document
> > to HTML? Leave them out?
> 
> Actually I'd love support for LaTeX blocks. In HTML they could be
> rendered to images or small PDF files displayed inline. That would be
> useful for scientific web pages that need complicated
> notations/equations, or just LaTeX examples, but I agree, this is more
> general than maths support; ideally that should allow for other
> external processors, e.g. graphviz

Generating images from LaTeX code is certainly possible. However, I
don't think that users expect that a simple document may generate more
than one output file...

If you want something more complicated than the conversion of markup
text to the HTML equivalent, you should probably use a static website
generator like [webgen][1]. Such a program allows you to combine the
features of kramdown with arbitrary other processors. For example,
webgen has a processor to generate TikZ pictures from a description
inside a kramdown document.

-- Thomas

From damien.pollet at gmail.com  Thu Jan 27 12:19:45 2011
From: damien.pollet at gmail.com (Damien Pollet)
Date: Thu, 27 Jan 2011 18:19:45 +0100
Subject: [kramdown-users] Feature Request: LaTeX Support in kramdown
In-Reply-To: <20110127160600.5bcee069@noweto>
References: 
	<20110127112817.0c1b28b4@noweto>

	<20110127160600.5bcee069@noweto>
Message-ID: 

On Thu, Jan 27, 2011 at 16:06, Thomas Leitner  wrote:
> Generating images from LaTeX code is certainly possible. However, I
> don't think that users expect that a simple document may generate more
> than one output file...

Well, a webpage can be viewed as a document but is rarely just a
single file, if you count the css and so on.

> If you want something more complicated than the conversion of markup
> text to the HTML equivalent, you should probably use a static website
> generator like [webgen][1]. Such a program allows you to combine the
> features of kramdown with arbitrary other processors. For example,
> webgen has a processor to generate TikZ pictures from a description
> inside a kramdown document.

Yes of course, that's the use-case I'm thinking about. There is some
feature overlap between kramdown alone for a single page and webgen
obviously, so I was wondering what's needed to ease integration; maybe
just a generic way to syntactically escape from markdown.

-- 
Damien Pollet
type less, do more [ | ] http://people.untyped.org/damien.pollet

From t_leitner at gmx.at  Fri Jan 28 12:54:46 2011
From: t_leitner at gmx.at (Thomas Leitner)
Date: Fri, 28 Jan 2011 18:54:46 +0100
Subject: [kramdown-users] Feature Request: LaTeX Support in kramdown
In-Reply-To: 
References: 
	<20110127112817.0c1b28b4@noweto>

	<20110127160600.5bcee069@noweto>

Message-ID: <20110128185446.51a9d2d5@noweto>

On 2011-01-27 18:19 +0100 Damien Pollet wrote:
> On Thu, Jan 27, 2011 at 16:06, Thomas Leitner 
> wrote:
> > Generating images from LaTeX code is certainly possible. However, I
> > don't think that users expect that a simple document may generate
> > more than one output file...
> 
> Well, a webpage can be viewed as a document but is rarely just a
> single file, if you count the css and so on.

You are right but *kramdown* does only generate one output file! All
other files have to be created by the user.

> > If you want something more complicated than the conversion of markup
> > text to the HTML equivalent, you should probably use a static
> > website generator like [webgen][1]. Such a program allows you to
> > combine the features of kramdown with arbitrary other processors.
> > For example, webgen has a processor to generate TikZ pictures from
> > a description inside a kramdown document.
> 
> Yes of course, that's the use-case I'm thinking about. There is some
> feature overlap between kramdown alone for a single page and webgen
> obviously, so I was wondering what's needed to ease integration; maybe
> just a generic way to syntactically escape from markdown.

Escaping from markdown can be done with `{::nomarkdown}...{:/}` in
kramdown. So this is already possible.

Regarding webgen: I'm currently in the process of implementing the next
major webgen version and I will make it still easier to extend or
override webgen's functionality. So if you have any ideas/requests,
don't hesitate to write a mail to the 
mailing list!

-- Thomas