On Tue, Apr 07, 2009 at 07:40:47AM -0700, John MacFarlane wrote:
> > Other options that occur to me are:
> >
> > - Get pandoc to have a plain text output format.
> >
> > - Dump it as HTML to a file, then call $BROWSER on it.
> >
> > - Emit markdown format if man(1) isn't installed.
> >
> > Unfortunately, apart from the (mostly unobtrusive) markdown text,
> > this appears to contain no wrapping, so you end up with lines
> > hundreds of characters long and they look ugly in less(1) or
> > whatever. Possibly pipe it through fmt(1) safely... but Windows
> > users won't have that either.
>
> Pandoc can emit markdown with wrapped lines (in fact, it wraps lines by
> default).
Ah, maybe I didn't see that because I was using pandoc-the-library not
pandoc-the-executable to turn hand-made pandoc objects into markdown.
(Unfortunately I have lost that draft, waah!)
> It would also be fairly easy to transform the native pandoc document
> after parsing but before writing, if you wanted a format that looked
> slightly different than markdown.
Basically I would like an output format that doesn't to markup things.
For example, it would not have backticks around `literal text`,
because that's not what those uninitiated in markdown would expect
when they ask for "darcs foo --help".
I conceive of this as a distinct, lossy output target. It would not
need to be particularly complex, but it would need to e.g. know how to
indent lines twice if you had an itemized list within a blockquote.
Or another example of needing to be slightly smart would be an list
item that wraps across multiple lines:
This is ugly:
* Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed
do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim
ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut
aliquip ex ea commodo consequat. Duis aute irure dolor in
reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla
pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
culpa qui officia deserunt mollit anim id est laborum.
compared to this:
* Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed
do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat. Duis aute
irure dolor in reprehenderit in voluptate velit esse cillum
dolore eu fugiat nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui officia deserunt
mollit anim id est laborum.
> I could help with this if you told me what you needed.
Glad to hear it. We're still at the "talking about it" stage, because
I'm so lazy, but I'm trying to sneak up on the "actually implement the
damn thing" stage before my procrastination notices.
_______________________________________________
darcs-users mailing list
[email protected]
http://lists.osuosl.org/mailman/listinfo/darcs-users
