Date: Mon, 23 Jul 2001 20:30:41 +0100 From: Nik Clayton <nik@freebsd.org> To: doc@freebsd.org Subject: Introducing OMF Message-ID: <20010723203041.A806@canyon.nothing-going-on.org>
next in thread | raw e-mail | index | archive | help
[-- Attachment #1 --]
One of the things that was discussed at the O'Reilly Documentation
Summit yesterday was the use of the Open Source Metadata Framework (OMF)
for categorising and cataloging documentation.
More information about OMF at
http://www.ibiblio.org/osrt/omf/index.html
http://www.ibiblio.org/osrt/omf/faq.html
It seems that the other documentation projects are in favour of adopting
this standard for categorising their documentation, and projects are
springing up to present this information to the user in a useful format.
For example, scrollkeeper,
http://sourceforge.net/projects/scrollkeeper/
which is also available as ports/textproc/scrollkeeper.
So I've started thinking about how to use OMF within the FreeBSD docs.
It seems like the simplest approach would be add a new file to each
document directory, called something like 'omf.xml', containing the
metadata for that document. This file might be maintained by hand, or
(some of it) might be automatically generated from our DocBook source --
this is because there are also moves afoot to make sure that the OMF
metadata set is available inside the *info DocBook elements.
Anyone else fancy looking at this in more detail before I get to it?
N
--
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 ---
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
Comment: For info see http://www.gnupg.org
iEYEARECAAYFAjtce2AACgkQk6gHZCw343VwUACfagovwT1tKFnORPRbLbSzDTtJ
XnEAnj3BlavoITwmMBzc/tX0WffNY4v3
=MSlf
-----END PGP SIGNATURE-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010723203041.A806>