Still Reviewing Web Pages

I'm still reviewing web pages in preparation for the migration of opensolaris.org to XWiki. So far I've finished reviewing the ON Developer Reference and the SCM-related pages in the Tools web space.

The only thing left for (my) review is the SCM Migration project web space. Since that project is no longer active, I don't plan to look too carefully. But a sanity check does seem in order, and maybe there are some obsolete pages or attachments that we can delete.

The ON Developer Reference (DevRef) is a particularly tough case for the migration software because of its extensive use of anchored links. I had been planning to retire the XML (Docbook) source that the DevRef currently uses, and keep everything in XWiki markup, but I'm not looking forward to fixing all the cross-references. So I'm having second thoughts about that strategy.

Comments:

Is fixing up the xrefs something that isn't automatable? (for that matter, would it be easier to semi-automate a translation from the docbook?)

I'd really like to see this wikified so that it's less cumbersome to maintain (and thus more likely to be maintained by more people).

Posted by richlowe on August 22, 2009 at 11:10 AM PDT #

Fixing up the xrefs is probably automatable, but it's non-trivial, because XWiki doesn't let you define the anchor name. Instead, it derives the anchor name from the section heading text.

Roland Mainz said he'd check for a mechanism to generate wiki markup from Docbook, but I'm not hopeful he'll find something.

Posted by Mike Kupfer on August 23, 2009 at 06:47 AM PDT #

Post a Comment:
Comments are closed for this entry.
About

Random information that I hope will be interesting to Oracle's technical community. The views expressed on this blog are my own and do not necessarily reflect the views of Oracle.

Search

Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today