Documentation Tools

Modify ↓

Ticket #39 (closed refactor: fixed)

Opened 5 years ago

Last modified 4 years ago

Restructure for multiple inputs

Reported by: kate Owned by: kate
Priority: major Component: Miscellaneous
Version: Monolithic Keywords:
Cc:

Description

Currently I've only been working on Docbook as an input language. Everything I've done revolves around that. We want to provide multiple InputLanguages as well as OutputFormats, so things need splitting up internally to support that.

Hopefully we can keep certain things common between InputLanguages.

Attachments

Change History

comment:1 Changed 5 years ago by kate

  • Type changed from enhancement to refactor

comment:2 Changed 5 years ago by kate

Perhaps something like this: 

# boring bits omitted

Mk                  # entry-points for makefiles
Mk/docbook.mk
Mk/man.mk
Mk/puredocs.mk
Mk/common.mk
Mk/website.mk       # docbook-website interface

website/xsl/xhtml   # website-to-xhtml

puredocs/xsl/docbook # puredocs-to-docbook
puredocs/xsl/xhtml  # puredocs-to-xhtml

docbook/xsl/texml   # docbook-to-texml (currently xsl/texml)
docbook/xsl/xhtml   # docbook-to-xhtml (currently xsl/xhtml)
docbook/tex         # TeX for rendering docbook (currently tex)

common/xsl          # XSL common to all input formats (e.g. inter-document links) (currently xsl/common)
common/tex          # TeX common to all input formats (e.g. ConTeXt configuration stuff)

themes
themes/wpi
themes/bland        # or whatever

test                # acceptance tests

Of course this would break all our fragile paths. and cause the handful of projects using it to need to update their themes for the relocated docbook xsl, and such. This might be a good opportunity to sort out some consistent variables for specifying paths.

comment:3 Changed 5 years ago by anonymous

This is to be merged into trunk/doc/namespaces/implementation.xml.

comment:4 Changed 4 years ago by kate

  • Status changed from new to closed
  • Version set to Monolithic
  • Resolution set to fixed

This has since become the modular system.

View ↑

Add a comment

Modify Ticket

Action
as closed
Author


E-mail address and user name can be saved in the Preferences.

Attachments ↑
 
Note: See TracTickets for help on using tickets.