How to build the Django book?

[voger]

The django book was my first contact with django but as the website
itself states it is way out of date (covering django 1.0 and mentioning
here and there 1.4). The same website suggests their github page

https://github.com/jacobian/djangobook.com

where the book updates are work in progress attempting to keep it up
to date with more recent versions of Django. The thing is, how do I read
this book? How can I compile the code to produce helpful readable
format? I am using Linux.

[Russell Keith-Magee]

Hi Voger,

The Django Book is written in using Sphinx. Sphinx is a tool you can install from PyPI --

pip install sphinx

Once you've got Sphinx installed, you can use "make" to control the build; run 

make html

to make a HTML target; the front page of the book will be put in _build/html/index.html.

You can also build epub, texinfo, and a variety of other formats if you need to.

Yours,

Russ Magee %-)

[voger]

On 11/10/2013 12:57 AM, Russell Keith-Magee wrote:
>
> On Sun, Nov 10, 2013 at 12:05 AM, voger <vogernew...@yahoo.gr
> <mailto:vogernew...@yahoo.gr>> wrote:
>
> The django book was my first contact with django but as the website
> itself states it is way out of date (covering django 1.0 and
> mentioning here and there 1.4). The same website suggests their
> github page
>

> https://github.com/jacobian/__djangobook.com

> <https://github.com/jacobian/djangobook.com>
>
> where the book updates are work in progress attempting to keep it
> up to date with more recent versions of Django. The thing is, how do
> I read this book? How can I compile the code to produce helpful
> readable format? I am using Linux.
>
>
> Hi Voger,
>
> The Django Book is written in using Sphinx. Sphinx is a tool you can
> install from PyPI --
>
> pip install sphinx
>
> Once you've got Sphinx installed, you can use "make" to control the
> build; run
>
> make html
>
> to make a HTML target; the front page of the book will be put in
> _build/html/index.html.
>
> You can also build epub, texinfo, and a variety of other formats if you
> need to.
>
> Yours,
> Russ Magee %-)
>

Thanks. It worked. :)

[Russell Keith-Magee]

On Mon, Nov 11, 2013 at 1:42 AM, Dennis Lee Bieber <wlf...@ix.netcom.com> wrote:

On Sun, 10 Nov 2013 11:11:06 +0200, voger <vogernew...@yahoo.gr>
declaimed the following:

>> The Django Book is written in using Sphinx. Sphinx is a tool you can
>> install from PyPI --
>>
>> pip install sphinx
>>
>> Once you've got Sphinx installed, you can use "make" to control the
>> build; run
>>
>> make html
>>

        Slipping into the thread...

        Now do you have a compatible make utility for Windows? Without having
to install a whole UNIX clone environment.

        Neither the M$ Visual Studio Visual C nmake nor GNAT Ada gnatmake like
the Makefile (nmake complains about a $ in macro, gnatmake objects to #
comment lines and _xxx names)

There isn't one in the djangobook repository, but there is a Sphinx make.bat file in the Django repository, and it's fairly generic. I haven't tried this, but you'll probably find that the make.bat file in django/docs can be used, or can be used with some very minor modifications.

Yours,

Russ Magee %-)