openstack-doc-core team mailing list archive
-
openstack-doc-core team
-
Mailing list archive
-
Message #00001
Re: conventions for docbook element usage
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
>> 1) "Information or configuration files that the user has to type
>> or read"
>>
>> This uses <literallayout>. I would propose using
>> <programlisting>.
>
> That's fine by me, though it'll take a while to change them all.
We could make the change programmatically, either with an xslt or in
this case even with find-and-replace-in-files in Oxygen.
>> 6) "File names"
>>
>> Instead of <literallayout>, <filename>
>>
> Okay. When we do this the output may not yet do anything to
> indicate it is marked up but we'll need to find out.
<filename> is currently formatted as monospace.
David
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
iQEcBAEBAgAGBQJPU6ugAAoJEMHeSXG7afUh7MYH/1IeEAtBEM4AoMdeolrTGoEK
Ta+K2uQOgOBqNqhzyWjCAlozzmz3Z6C7tGllMJPxHD1NOJjpVubinSXwLQZVOetC
cgsBBbZkMeLxic/zRWlVdFhiGED9FkAEhzHL6ek6AfVmKO+fI8/DT0BnILRRrQww
4Z0FnZv4rP2J5I8TeCixDnC9kqCOQRcJni/JD3jeJIBAgeZ6F9XzeKYk+0EkaKa+
nHUFW3LRAxRRLF88y81MsB/z+XoGu5ATn4asprHWoatLNRZFXbTVmpe4i988Lrp2
3TMjbayuK/rWUmfDSEPw37DKpCDRSYbP6bjW6OpDDs0ySYoYzymoWDVdi2B0nIc=
=jkTb
-----END PGP SIGNATURE-----
Follow ups
References