lua-users home
lua-l archive

[Date Prev][Date Next][Thread Prev][Thread Next] [Date Index] [Thread Index]


On Wed, Jan 5, 2011 at 23:01, LeafStorm <leafstormrush@gmail.com> wrote:
> On 01/04/2011 10:30 PM, Alexander Gladysh wrote:

>> I have set up the organization

>> https://github.com/lua-cookbook/

>> on GitHub.

> It may be a bit too early to make infrastructure decisions, but have you
> looked at Sphinx (http://sphinx.pocoo.org/) for actually writing the book? I
> think it's a pretty good fit, since it's designed for writing documentation,
> it takes care of a lot of the "infrastructure" stuff, and it can output to
> HTML and LaTeX. (It's written in Python, which some people may consider a
> downside, but I don't think it's that big of a deal.)

Looks interesting. Can you, maybe, provide an example if you already
used this system? (You may commit it right to the repository, or
create a GitHub gist.) Or, if I overlooked existing one, just point me
to the URL.

I know that the Markdown + Pandoc works (not perfect, but works). I
also know that there are many less convenient setups. If the process
is too complicated, it will harm the contribution rate.

> Also, it may be a good idea to set up a separate mailing list or Google
> Group for the cookbook project, to avoid crowding lua-l or the project wiki
> with discussion.

Will do.

> (PS: My Github username is "leafstorm".)

Added, thank you!

Alexander.