Skip to end of metadata
Comment: Migrated to Confluence 4.0
Go to start of metadata

General Considerations

Aptconvert's original APT format has several limitations, that pose problems for Doxia's more general scope. We need to decide wether we want to retain compatibility with aptconvert (and clearly state its limitations), or if we want to modify it to meet Doxia's need. I'd vote for the latter. I propose to modify the current Apt guide, highlighting the changes wrt aptconvert's version, see DOXIA-138 .

List of proposals

  1. Figure extensions: see DOXIA-99. We could implement what I proposed there (which would be compatible with aptconvert). I'd rather suggest that figures should be specified with extensions. They are just links, and so shouldbe valid as such.
  2. Table header cells have already been implemented in the parser, see Denis' comments at DOXIA-138.
  3. Link/anchor handling. We have already cleaned that up in alpha-9 (see DOXIA-29, DOXIA-47, DOXIA-94, DOXIA-131) but we need to document it.
  4. Allow inline images? See DOXIA-43
  5. Support of style See DOXIA-63

Votes

+1: vsiveton
+0:
-1:

Labels
  • None

4 Comments

Hide/Show Comments

  1. Sep 12, 2007

    Vincent Siveton

    As mentioned in DOXIA-138, the AptParser has already new functionalities (like ||) not supported by aptconvert. It is a  reasonable concern to fork aptconvert to meet with Doxia's needs.

  2. Sep 25, 2007

    Lukas Theussl

    The || markup for table header cells doesn't work with grid-less tables. I like the following better (taken from ReST):

    +------------------------+------------+----------+
| Header row, column 1   | Header 2   | Header 3 |
+========================+============+==========+
| body row 1, column 1   | column 2   | column 3 |
+------------------------+------------+----------+
| body row 2             | Cells may span        |
+------------------------+-----------------------+

    Note that also allows cell spanning. 

  3. Nov 10, 2009

    Dave Syer

    What about adding support for some of the attributes discussed in DOXIA-204 (and friends)?  The Sink now has support for figures to contain attributes like width and height (which are generally pretty useful) but APT doesn't support that yet as far as I can tell.

  4. Nov 11, 2009

    Lukas Theussl

    I am not in favor of further modifying the apt format, I think it will be more confusing than helpful. I think what people appreciate most with apt is its simplicity, the ability to quickly write simple documents without having to learn any markup language. If you need more advanced options, you can always switch to a different document format (xdoc,...).