Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: neutral (athena.apache.org: local policy)
Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Apple Message framework v1278)
Subject: Re: Sphinx docs
From: Hans J Schroeder <hs@cloudno.de>
In-Reply-To: 
 <CAKmKYaAa5eTLGdYZ533FytZAnUAKqDe3CdAiGZeoOxk-frLW3A@mail.gmail.com>
Date: Sat, 4 Aug 2012 11:25:33 +0200
Content-Transfer-Encoding: 7bit
Message-Id: <1A7E08ED-7797-4096-9980-094ABD666C25@cloudno.de>
References: 
 <CAKmKYaAa5eTLGdYZ533FytZAnUAKqDe3CdAiGZeoOxk-frLW3A@mail.gmail.com>
To: dev@couchdb.apache.org

This is great, thanks. 

For those building on Mac OS X:

When "make html" stops with: ValueError: unknown locale: UTF-8

set the following env vars:

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

- Hans
 
On Aug 3, 2012, at 7:01 PM, Dirkjan Ochtman wrote:

> On Fri, Aug 3, 2012 at 4:00 PM, Noah Slater <nslater@tumbolia.org> wrote:
>> Dirkjan, please just concentrate on getting the output targets of your
>> existing Makefile working. (The Makefile I saw when I checked out your
>> Github repo last.) Don't bother yourself with Autotools. Just get the docs
>> dir working as if it were a separate concern, and I will take care of
>> integration.
> 
> Okay, I think this is done. You can still see the current result here:
> 
> http://couchdb.readthedocs.org/en/latest/index.html
> 
> I've tested the html and texinfo targets so far, both seem to be fine.
> I've also left a TODO.txt for everyone who'd like to help out
> improving the docs and just needs a little nudge in the right
> direction.
> 
> I have not removed the DocBook-based docs yet, since they are used in
> the build system and I didn't feel like messing with Noah's baby. ;)
> (Also, listing each and every HTML file seems incredibly tedious.) You
> can get the good stuff from https://github.com/djco/couchdb/tree/docs.
> I'm not sure whether it should be merged to master first, then
> included with the build system, or the other way around.
> 
> Basic workflow is this:
> 
> - Install docutils, pygments and sphinx via your system package
> manager, easy_install or pip
> - Go to share/sphinx-docs
> - Edit any .rst files
> - make html
> - Lather, rinse, repeat
> 
> Helpful docs for those new to dealing with reST/Sphinx:
> 
> http://docutils.sourceforge.net/docs/user/rst/quickstart.html
> http://sphinx.pocoo.org/rest.html
> 
> Also, I'm going on vacation for a bit. I'll be around a little bit
> this weekend if there's anything you need from me, then I'll be gone
> for a week without network.
> 
> Cheers,
> 
> Dirkjan