Opened 14 years ago

Closed 13 years ago

#1527 closed enhancement (duplicate)

Makefile for HTML documentation

Reported by: Andy Dustman <farcepest@…> Owned by: Jacob
Component: Documentation Version: master
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


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 $< $@

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

Assumes docutils and 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@…> 14 years ago.
Makefile for docs to convert ReST -> HTML

Download all attachments as: .zip

Change History (8)

Changed 14 years ago by Andy Dustman <farcepest@…>

Attachment: Makefile added

Makefile for docs to convert ReST -> HTML

comment:1 Changed 14 years ago by Adrian Holovaty

Whoa, this is pretty cool. Thanks!

comment:2 Changed 14 years ago by Andy Dustman <farcepest@…>

Cc: farcepest@… added
Version: magic-removalSVN

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

comment:3 Changed 14 years ago by Andy Dustman <farcepest@…> 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 Changed 14 years ago by Gary Wilson <gary.wilson@…>

milestone: Version 0.92Version 1.0

0.92 is long gone.

comment:5 Changed 14 years ago by (none)

milestone: Version 1.0

Milestone Version 1.0 deleted

comment:6 Changed 14 years ago by Simon G. <dev@…>

Triage Stage: UnreviewedAccepted

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

comment:7 Changed 13 years ago by Marc Fargas <telenieko@…>

Resolution: duplicate
Status: newclosed

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 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