Welcome to NeoOffice developer notes and announcements
NeoOffice
Developer notes and announcements
 
 

This website is an archive and is no longer active
NeoOffice announcements have moved to the NeoOffice News website


Support
· Forums
· NeoOffice Support
· NeoWiki


Announcements
· Twitter @NeoOffice


Downloads
· Download NeoOffice


  
NeoOffice :: View topic - help files
help files
 
   NeoOffice Forum Index -> NeoOffice/C Development
View previous topic :: View next topic  
Author Message
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Wed Oct 22, 2003 11:37 am    Post subject: help files

problem: converting from OO.o specific help file format (XML) to Apple Help file format (HTML3.2)

solution: ask the web programmer to do it (that's me)

**

last night i started working on this project. i wrote the perl script to transverse the help files and alter them, creating a mirror directory of the new files. (need to add routine to skip non-XML files, like images)

next step is to translate XML tags and styles into basic HTML.

following that, additional tags specific to Apple Help to be added. (this will be the next level detail of previous step) will make a nifty neooffice help start page.

following that, following that, will be to go through all files and check them, first for functionality (did you get your scripts right?) then for information (but i don't have a start menu!).

then poof! it will be ready. time for integration into neooffice.

will update with the excitement as it comes. Very Happy

-jake

extra stuff: change pictures from windows machines to Macs.
Back to top
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Wed Oct 22, 2003 7:40 pm    Post subject:

Tested the alteration routines I wrote on some actualy files, debugged as necassary. Starting adding in real changes.

The help files stored link information in separate file, so I wrote a script to parse the .tree files and turn the information into HTML links stored in a hash. when i am awake i'll figure out why my while loop isn't working.

Am slowly (or quickly, depending on POV) remembering regular expressions.

Need to do next:
write routine to swap xml links with html links
routine to change the meta information from xml into title and meta tags
add in formatting

that's all for now.

-jake
Back to top
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Mon Nov 03, 2003 12:16 pm    Post subject:

so both parts worked individually, one program went through an entire structure and made links in a mirror folder, the second took a file and converted it (mostly) from XML to HTML

combining them has not worked so nicely. mostly i have thought of creative explicatives, then got distraced with iMovie.

i did, however, get the first link file to work. the XML links were just ID numbers stored in secondary files (*.tree). perl program runs through each file and converts them to a single file with a hash

%link{ID#} = "HTML link"

found that link information is also in a second type of file, need to write the regexp to pull those too (because of course they are different).

meta from xml to html is about half complete.

-jake
Back to top
Guest






PostPosted: Fri Nov 12, 2004 5:10 am    Post subject:

jakeOSX wrote:
so both parts worked individually, one program went through an entire structure and made links in a mirror folder, the second took a file and converted it (mostly) from XML to HTML

combining them has not worked so nicely. mostly i have thought of creative explicatives, then got distraced with iMovie.

i did, however, get the first link file to work. the XML links were just ID numbers stored in secondary files (*.tree). perl program runs through each file and converts them to a single file with a hash

%link{ID#} = "HTML link"

found that link information is also in a second type of file, need to write the regexp to pull those too (because of course they are different).

meta from xml to html is about half complete.

-jake
Back to top
Guest






PostPosted: Fri Nov 12, 2004 5:10 am    Post subject:

Anonymous wrote:
jakeOSX wrote:
so both parts worked individually, one program went through an entire structure and made links in a mirror folder, the second took a file and converted it (mostly) from XML to HTML

combining them has not worked so nicely. mostly i have thought of creative explicatives, then got distraced with iMovie.

i did, however, get the first link file to work. the XML links were just ID numbers stored in secondary files (*.tree). perl program runs through each file and converts them to a single file with a hash

%link{ID#} = "HTML link"

found that link information is also in a second type of file, need to write the regexp to pull those too (because of course they are different).

meta from xml to html is about half complete.

-jake
Back to top
Guest






PostPosted: Fri Nov 12, 2004 5:10 am    Post subject:

Anonymous wrote:
Anonymous wrote:
jakeOSX wrote:
so both parts worked individually, one program went through an entire structure and made links in a mirror folder, the second took a file and converted it (mostly) from XML to HTML

combining them has not worked so nicely. mostly i have thought of creative explicatives, then got distraced with iMovie.

i did, however, get the first link file to work. the XML links were just ID numbers stored in secondary files (*.tree). perl program runs through each file and converts them to a single file with a hash

%link{ID#} = "HTML link"

found that link information is also in a second type of file, need to write the regexp to pull those too (because of course they are different).

meta from xml to html is about half complete.

-jake
Back to top
Guest






PostPosted: Fri Nov 12, 2004 5:10 am    Post subject:

Anonymous wrote:
Anonymous wrote:
jakeOSX wrote:
so both parts worked individually, one program went through an entire structure and made links in a mirror folder, the second took a file and converted it (mostly) from XML to HTML

combining them has not worked so nicely. mostly i have thought of creative explicatives, then got distraced with iMovie.

i did, however, get the first link file to work. the XML links were just ID numbers stored in secondary files (*.tree). perl program runs through each file and converts them to a single file with a hash

%link{ID#} = "HTML link"

found that link information is also in a second type of file, need to write the regexp to pull those too (because of course they are different).

meta from xml to html is about half complete.

-jake
Back to top
Guest






PostPosted: Fri Nov 12, 2004 5:11 am    Post subject:

[quote="Anonymous"][quote="Anonymous"][quote="jakeOSX"]so both parts worked individually, one program went through an entire structure and made links in a mirror folder, the second took a file and converted it (mostly) from XML to HTML

combining them has not worked so nicely. mostly i have thought of creative explicatives, then got distraced with iMovie.

i did, however, get the first link file to work. the XML links were just ID numbers stored in secondary files (*.tree). perl program runs through each file and converts them to a single file with a hash

%link{ID#} = "HTML link"

found that link information is also in a second type of file, need to write the regexp to pull those too (because of course they are different).

meta from xml to html is about half complete.

-jake[/quote][/quote][/quote]
Back to top
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Fri Nov 12, 2004 10:03 am    Post subject:

sweet, someone thought it would be cool to quote my post five times!

err. or something.

(speaking of which, i need to do something about this...)

-j
Back to top
ovvldc
Captain Naiobi


Joined: Sep 13, 2004
Posts: 2352
Location: Zürich, CH

PostPosted: Fri Nov 12, 2004 7:16 pm    Post subject:

jakeOSX wrote:
sweet, someone thought it would be cool to quote my post five times!

err. or something.


Perhaps you missed a calling to write prize winning literature? If you manage to make fans with a simple technical message, the sky is the limit..

Anyway, thanks for the work. I was hoping for this, as the current help system is not *that* nice.
Back to top
pluby
The Architect
The Architect


Joined: Jun 16, 2003
Posts: 11949

PostPosted: Fri Nov 12, 2004 8:16 pm    Post subject:

This is a bit off-topic, but I keep thinking that at some point it would be nice to be able to have a script or some other tool to run all of the help files for each language through that would search and replace all of those damn "Ctrl" and "Control" key sequences with "Command" and replace all of the "Meta" key sequences with "Control".

The OOo doc writers used to put a conditional flag in the XML help files but the stopped doing that after OOo 1.0.3. Sad

Patrick
Back to top
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Sat Nov 13, 2004 6:48 am    Post subject:

Patrick,

I'll add that into the list of things to convert, it shouldn't (he says at this time of morning) be too hard...
Back to top
pluby
The Architect
The Architect


Joined: Jun 16, 2003
Posts: 11949

PostPosted: Sat Nov 13, 2004 10:46 am    Post subject:

Would it be possible to do this "Ctrl/Control" replacement in only the XML files? I ask because there is in sudden interest in releasing Neo/J language packs with the localized help files. If I create these language packs, it would be cool to be able to do the replacements in the XML help beforehand.

If it helps, here is how the conditionalize in the XML help files used to be in OOo 1.0.3:

<help:switch select="System"><help:case select="MAC">Command</help:case><help:default>Ctrl</help:default></help:switch>

whereas in OOo 1.1.2 they just have:

Ctrl

Patrick
Back to top
jakeOSX
Ninja
Ninja


Joined: Aug 12, 2003
Posts: 1373

PostPosted: Mon Nov 15, 2004 6:53 am    Post subject:

i'll admit my java is better than my XML...

but if it is just a straight replacement, then a quick s/ctrl/command/ (in Perl) should work, unless there is more i am missing...
Back to top
ovvldc
Captain Naiobi


Joined: Sep 13, 2004
Posts: 2352
Location: Zürich, CH

PostPosted: Mon Nov 15, 2004 8:04 am    Post subject: XSLT?

jakeOSX wrote:
i'll admit my java is better than my XML...

but if it is just a straight replacement, then a quick s/ctrl/command/ (in Perl) should work, unless there is more i am missing...


Just out of curiousity, why didn't you do an XSLT on the help files? That is what makes XML so useful as a format, if I understand it correctly...
Back to top
Display posts from previous:   
   NeoOffice Forum Index -> NeoOffice/C Development All times are GMT - 7 Hours
Goto page 1, 2  Next
Page 1 of 2

 
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
You cannot attach files in this forum
You cannot download files in this forum

Powered by phpBB © 2001, 2005 phpBB Group

All logos and trademarks in this site are property of their respective owner. The comments are property of their posters, all the rest © Planamesa Inc.
NeoOffice is a registered trademark of Planamesa Inc. and may not be used without permission.
PHP-Nuke Copyright © 2005 by Francisco Burzi. This is free software, and you may redistribute it under the GPL. PHP-Nuke comes with absolutely no warranty, for details, see the license.