Opened 19 years ago

Closed 18 years ago

#1527 closed enhancement (duplicate)

Makefile for HTML documentation

Reported by: Andy Dustman <farcepest@…> Owned by: Jacob
Component: Documentation Version: dev
Severity: trivial Keywords:
Cc: farcepest@… Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

I wanted to be able to read the current SVN docs as HTML, so I put together a small Makefile (to go in the docs directory):

.SUFFIXES = .txt .html

%.html : %.txt
        rst2html.py $< $@

objects := $(patsubst %.txt,%.html,$(wildcard *.txt))
all: $(objects)

Assumes docutils and rst2html.py on your path, and GNU Make. Running make processes any .txt files to .html as needed. Will add as an attachment too to preserve tabs.

Attachments (1)

Makefile​ (129 bytes ) - added by Andy Dustman <farcepest@…> 19 years ago.
Makefile for docs to convert ReST -> HTML

Download all attachments as: .zip

Change History (8)

by Andy Dustman <farcepest@…>, 19 years ago

Attachment: Makefile​ added

Makefile for docs to convert ReST -> HTML

comment:1 by Adrian Holovaty, 19 years ago

Whoa, this is pretty cool. Thanks!

comment:2 by Andy Dustman <farcepest@…>, 19 years ago

Cc: farcepest@… added
Version: magic-removal → SVN

Switched to SVN version since magic-removal is no longer relevant.

comment:3 by Andy Dustman <farcepest@…>, 18 years ago

buildhtml.py which comes with distutils will also do the same job, although it always rebuilds everything, unlike make which only rebuilds when the source is modified.

comment:4 by Gary Wilson <gary.wilson@…>, 18 years ago

milestone: Version 0.92 → Version 1.0

0.92 is long gone.

comment:5 by (none), 18 years ago

milestone: Version 1.0

Milestone Version 1.0 deleted

comment:6 by Simon G. <dev@…>, 18 years ago

Triage Stage: Unreviewed → Accepted

Accepted on the basis of "whoa, this is cool!"

comment:7 by Marc Fargas <telenieko@…>, 18 years ago

Resolution: → duplicate
Status: new → closed

I think we can mark this as a duplicate of #528, #528 is about a PDF/HTML generator.
On the other hand this patch requires make and rst2html.py and the first one can be a bit tricky to have on some platforms (win..)

So, marking as duplicate of #528 ;)

Note: See TracTickets for help on using tickets.
Back to Top