Announcement: Publican 2 released
by Ruediger Landmann
Publican 2 is finally finished and released. The most significant update
is the incorporation of the web-publishing component that was previously
used stand-alone by Red Hat internally and, more recently, has been used
by the Fedora Documentation Project to build the Fedora documentation
suite.[0] With web publishing built in, Publican can handle the whole
publication process from raw XML to a live website. The new feature is
documented in a new chapter in the Users' Guide.[1]
Apart from this major new feature, Publican 2 also includes fixes for
several bugs; most notably: xrefs to various elements that didn't work,
problems with <indexterms> for translators, and various presentation flaws.
No changes are required to documents created with (or updated with)
Publican 1.x to make them build in Publican 2. The "publican old2new"
command remains available to update documents created with Publican 0.x
so that they will build in Publican 2.
Publican 2 is not yet available as a Fedora update; however, you can
download builds from the Fedora build system (Koji) for testing[1]. If
Publican 2 works for you, help make it available for others. Visit the
Fedora update system (Bodhi),[2] log in with your Fedora ID, and give
positive Karma to the package. Note that if you do not log in to Bodhi,
your feedback will not count.
Cheers,
Rudi
Changelog:
- Add Publican::Website.
- Add web_*_label params for web menus.
- Add underscores to cleanset, installbrand, and printtree. BZ #581090
- Update docs with Website content
- Update brand license text.
- Fix different log jar path on F14+
- Add constraint to help_config output.
- Fix segfault when indexterm has no leading content. BZ #592666
- Fix inline indexterm. BZ #592823
- Translate productname tag. BZ #592669
- Fix formalpara missing ID. BZ #595564
- Add dummy lang.css to avoid 404's. BZ #595799
- Improve validation error message. BZ #593887
- Fix qandaentry ID. BZ #593892
- Fix Icon non-conformance. BZ #593890
- Fix admonitions splitting across pages. BZ #596257
- Fix HTML simple list border. BZ #599258
- Fix formal object IDs. BZ #601363
- Fix Revision History layout. BZ #559787 #598828 #598833
- Remove title color from term in HTML. BZ #592822
- Fix highlight breaking callouts. BZ #590933
- Add support for LineColumn coords in area tag.
- Update font requires for F12 and F13.
- Fix clean_ids adding newline to verbatim. BZ #604465
- Fix index missing ID. BZ #606418
- Fix files dir being missed. BZ #609345
- Adjust admonition layout.
[0] http://docs.fedoraproject.org
[1] "Chapter 6. Building a website with Publican", available online at
http://jfearn.fedorapeople.org/en-US/Publican/2.0/html/Users_Guide/sect-U...
[2]
http://kojipkgs.fedoraproject.org/packages/publican/2.1/0.fc13/noarch/pub...
for Fedora 13 or
http://kojipkgs.fedoraproject.org/packages/publican/2.1/0.fc12/noarch/pub...
for Fedora 12
[3] https://admin.fedoraproject.org/updates/publican-2.1-0.fc13 for
Fedora 13 or https://admin.fedoraproject.org/updates/publican-2.1-0.fc12
for Fedora 12
13 years, 10 months
Self-Introduction
by Gadget Wisdom Guru
Guru, Gadget Wisdom, www.gadgetwisdom.com
I have long wanted to start contributing back to the Fedora project. I'm
not a developer, and at SELF, it was suggested I could help by
contributing to documentation. I like to think I write in a clear and
concise manner, and want to give it a shot.
I like to think of myself as an intermediate Fedora user who is eager to
convey what I learn to others. I'm not sure what other skills might be
useful to this. But I intend to find out.
I'll likely spend some time observing to figure out how I might best
begin contributing.
pub 2048R/70BC1402 2010-07-06
Key fingerprint = C002 0ACD F780 208D 838D 4E80 B1C7 CA56 70BC 1402
uid Gadget Wisdom (Fedora) <guru(a)gadgetwisdom.com>
sub 2048R/05BD728A 2010-07-06
13 years, 10 months
default link for untranslated books
by Domingo Becker
I was looking for the F13 install guide at the new docs site [1] but,
as there is no Spanish version yet, the site seems to indicate that
there is no install-guide at all [2].
Is it possible to have at the left the links to the English version
for the untranslated books?
So the Fedora documetation list is complete. New users will see
untranslated guides in English and would probably want to join us in
the translation efforts.
What do other language coordinators think?
[1] http://docs.fedoraproject.org/
[2] http://docs.fedoraproject.org/es-ES/index.html
kind regards
Domingo Becker
13 years, 10 months
Procedure for handling bugs in the Docs Project
by Eric Christensen
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
A couple of weeks ago I said I would develop procedures for handling bug
reports. At yesterday's meeting I think we got a general consensus on
what needs to happen in the life-cycle of a bug. I've documented what
we discussed in the meeting in the wiki[0] and await feedback.
[0] https://fedoraproject.org/wiki/Handling_Docs_Project_bugs
Thanks,
Eric
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.14 (GNU/Linux)
Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/
iQIcBAEBAgAGBQJMLWEXAAoJEDbiLlqcYamxnQ4P/0fvvd9RFw5CqgGReF+bBg/r
vGJUCbj89x/GE8N0rSDbgj0OiuvbCO3Ooc9FzTNuh1+khSVQRpkZPckBAdEXFNNZ
1vT349AUSPU2AZu8n7XpUKf5uEwpzBDumZnqgq7mYHopb98kkh91JV+uU3LV7RnO
E8XrLQF9p3/hlbCx0QKxsrguwZhacRzophFYhYxeY4aBF/H/R7ijBOnJDj4u/R3i
zzLBwRqWxEeBYjBry84o0oRjNHZu8cVkn7sBk76+UsN7qTMN3QILSnx/FRWkFmRD
rCyVFQ4UrqRuKsmSFznWNnGACbru14DG8Oflp2NIQk1ijXaHfH2c6wV8mpuvVY2D
hY/xAzOZVDqtwv4qGNXXXEpJ4XzIlfzukZpL/UnLNBUnvVEyC5roCdSxqY4P+n5p
en9ePIximgY9cEzOOBTM/tEgixKnRJ68SqFUCWd/eFNjZRg7vSAuhTO9LkbcfscA
ViSvC6laiYtcj4Sl2iOHXhOA5GqXv/myxHbfUccKVQdnVvHWw2nzmKXFkALywPtj
Lb3dqghKOkQgA5kyKkN6tcKwarjHNGjdBFgO7MzGDGFCucEIYmCWla9be+Fa0toz
rCFTyEH69EVe0mL3PMCDp+DnpqVMss+4FIonWfQuCDomEjyLq+/VhS1THN/IMm2F
0XxGA9rwgHePfhuonOTy
=VS2t
-----END PGP SIGNATURE-----
13 years, 10 months
