OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: Re: DOCBOOK: RFE #480954: Extend textobject to insert external files


--PGNNI9BzQDUtgA2J
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Tue, Feb 05, 2002 at 04:12:55PM -0500, Norman Walsh wrote:
> Here is a revised proposal for this RFE.
>=20
> Proposal: extend textobject to allow references to external text files
>=20
> The following trick is a common way to insert external sources
> directly into a DocBook document:
>=20
> <inlinemediaobject>
> <imageobject>
> <imagedata format=3D"linespecific" fileref=3D"filename"/>
> </imageobject>
> </inlinemediaobject>
>=20
> Several people have suggested that it would make more sense to
> allow a <textobject> to do this:
>=20
> <inlinemediaobject>
> <textobject>
> <textdata fileref=3D"filename"/>
> </textobject>
> </inlinemediaobject>

At the risk of opening up a couple of cans of worms. . .

 1.  I think <textdata> needs to support either 'class=3D"monospaced"'
     or 'format=3D"linespecific"'.

     This isn't necessary when you use <inlinemediaobject> inside a
     <programlisting> element (for example) but it is necessary inside
     <mediaobject>

     For example, I currently have a document where "fig1.eps" is a
     picture of a box with an 'A' inside it.  The markup I'm currently
     using for this is:

    <mediaobject>
      <imageobject>
        <imagedata fileref=3D"fig1" format=3D"EPS">
      </imageobject>
       =20
      <textobject>
        <literallayout class=3D"monospaced">+---------------+
|       A       |
+---------------+</literallayout>
      </textobject>

      <textobject>
        <phrase>A picture</phrase>
      </textobject>
    </mediaobject>

     I can't think of any reason why I won't always want the
     'class=3D"monospaced"' effect, but others might want a way to turn it
     off.

 2.  Do we want to use this as an 'escape hatch' to insert different
     files depending on the output format that's being generated?

     For example:

     <!-- Include hello.c -->

     <textobject>
        <!-- hello.c.tex is a specially marked up version that uses=20
	     TeX codes to improve the rendering -->
        <textdata format=3D"TEX" fileref=3D"hello.c.tex">

	<!-- hello.c is used for all other output formats -->
	<textdata fileref=3D"hello.c">
     </textobject>

N
--=20
FreeBSD: The Power to Serve      http://www.freebsd.org/               (__)
FreeBSD Documentation Project    http://www.freebsd.org/docproj/    \\\'',)
                                                                      \/  \=
 ^
   --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---         .\._/=
_)

--PGNNI9BzQDUtgA2J
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
Comment: For info see http://www.gnupg.org

iEYEARECAAYFAjx6gBQACgkQk6gHZCw343Xr+ACfTtso7OoPkfFucIffV2kbFDip
bucAnAh1g0yVX25kKMBvNyTVK+z1mdj6
=E/Xb
-----END PGP SIGNATURE-----

--PGNNI9BzQDUtgA2J--


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC