Date: Wed, 6 Aug 2014 16:05:49 -0700 (PDT)
From: TR NS <transfire@gmail.com>
To: lojban@googlegroups.com
Message-Id: <2cee2571-a652-48cb-b581-e97177c89074@googlegroups.com>
In-Reply-To: <20131227041501.GA21848@stodi.digitalkingdom.org>
References: <20131227041501.GA21848@stodi.digitalkingdom.org>
Subject: [lojban] Re: The CLL project, technical directions
MIME-Version: 1.0
Reply-To: lojban@googlegroups.com
Precedence: list
Mailing-list: list lojban@googlegroups.com; contact lojban+owners@googlegroups.com
Sender: lojban@googlegroups.com
Content-Type: multipart/alternative; 
	boundary="----=_Part_2965_378246036.1407366349715"
X-Spam_score: -1.9
X-Spam_score_int: -18
X-Spam_bar: -

------=_Part_2965_378246036.1407366349715
Content-Type: text/plain; charset=UTF-8

Hi. I probably can be of service to you. I am a programmer and have a fair 
bit of experience with markup systems. The first thing I can tell you is 
that docbook is a hell hole (been there done that), and you are right to 
want to find a better way. Problem is, as you have no doubt discovered, 
that *good* options are in short supply. Available solutions are either too 
complicated and time consuming and likely to lead right back to fresh hell 
hole, or they are too simplistic. What you need is a "goldilocks" solution.

While Sphinx looks like a promising choice, it falls a just a bit into the 
too complex category. It is also not really geared for this sort of 
project. It is primary for documenting Python projects. So it's likely you 
will find it a bit too constrictive too.

A better solution is Pandoc (http://johnmacfarlane.net/pandoc/) Pandoc will 
allow you to do just about everything you need in the simplest way 
possible. And the nice thing about Pandoc is that if there is something you 
need that it can't do, it supports plugins, so it can be added with just a 
bit of programming skill. Basically what you want to do is convert CLL to 
Markdown and take advantage of the plugins in the places that the standard 
markup doesn't cut it. Read about those here: 
http://johnmacfarlane.net/pandoc/README.html. If there is anything you 
can't find a way to do then let me know and I can see what I can do, if 
need be make a new plugin for it (though I actually doubt there is anything 
you'll need that isn't already covered).

.trans.


-- 
You received this message because you are subscribed to the Google Groups "lojban" group.
To unsubscribe from this group and stop receiving emails from it, send an email to lojban+unsubscribe@googlegroups.com.
To post to this group, send email to lojban@googlegroups.com.
Visit this group at http://groups.google.com/group/lojban.
For more options, visit https://groups.google.com/d/optout.

------=_Part_2965_378246036.1407366349715
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Hi. I probably can be of service to you. I am a programmer=
 and have a fair bit of experience with markup systems. The first thing I c=
an tell you is that docbook is a hell hole (been there done that), and you =
are right to want to find a better way. Problem is, as you have no doubt di=
scovered, that *good* options are in short supply. Available solutions are =
either too complicated and time consuming and likely to lead right back to =
fresh hell hole, or they are too simplistic. What you need is a "goldilocks=
" solution.<div><br></div><div>While Sphinx looks like a promising choice, =
it falls a just a bit into the too complex category. It is also not really =
geared for this sort of project. It is primary for documenting Python proje=
cts. So it's likely you will find it a bit too constrictive too.</div><div>=
<br></div><div>A better solution is Pandoc (http://johnmacfarlane.net/pando=
c/) Pandoc will allow you to do just about everything you need in the simpl=
est way possible. And the nice thing about Pandoc is that if there is somet=
hing you need that it can't do, it supports plugins, so it can be added wit=
h just a bit of programming skill. Basically what you want to do is convert=
 CLL to Markdown and take advantage of the plugins in the places that the s=
tandard markup doesn't cut it. Read about those here: http://johnmacfarlane=
.net/pandoc/README.html. If there is anything you can't find a way to do th=
en let me know and I can see what I can do, if need be make a new plugin fo=
r it (though I actually doubt there is anything you'll need that isn't alre=
ady covered).</div><div><br></div><div>.trans.</div><div><br></div><div><br=
></div></div>

<p></p>

-- <br />
You received this message because you are subscribed to the Google Groups &=
quot;lojban&quot; group.<br />
To unsubscribe from this group and stop receiving emails from it, send an e=
mail to <a href=3D"mailto:lojban+unsubscribe@googlegroups.com">lojban+unsub=
scribe@googlegroups.com</a>.<br />
To post to this group, send email to <a href=3D"mailto:lojban@googlegroups.=
com">lojban@googlegroups.com</a>.<br />
Visit this group at <a href=3D"http://groups.google.com/group/lojban">http:=
//groups.google.com/group/lojban</a>.<br />
For more options, visit <a href=3D"https://groups.google.com/d/optout">http=
s://groups.google.com/d/optout</a>.<br />

------=_Part_2965_378246036.1407366349715--