I have written two related books, let me call them 'beginner' and 'advanced'. There may be 3 more in this series eventually. Each is about 100 pages. Sphinx has been perfect for the project as I have been able to deliver as web, pdf, and epub (after a trip through Calibre to put on a cover). These books do not involve code. When I had everything in one big book it was too much for some people and would scare them off.
Right now I have simply two directories with their own Makefile, source subdirectory, conf.py and index files. So far when one book has to refer to the other I just use :title' to refer to the other book but I'd prefer of course to make a link when output is electronic, and to have the reference be more specific, and to be able to still make the documents individually. I could write a higher-level Makefile to make both of them, but I'm wondering if I'm missing the point on something. I am retired and the documentation seems to be all over the place between Sphinx and docutils and rst, and I just can't digest it like I used to. Help an old guy out? I speak Python. -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
