One idea would be to have an xml format for help files.
Then it can be translated automagically into
cocoa webkit html with a Helper-like mechanism.
Or in other eventually useful formats.
The xml could be more easily generated from sources (e.g. via AutoHelper).
How to generate the xml?
a. writing directly it
b. via a GUI which provides a set of predefined
forms (following the stylesheet and/or generated
by the Helper mechanism)
How to edit a help file?
a. directly editing it
b. via a Gui generated from the xml
Just 2c
-a-
On 18 Dec 2008, at 00:04, Julian Rohrhuber wrote:
Still, there's a major, higher issue here.
We want to maintain the domination of macosx in terms of ease of use.
That's ok (I'm on mac).
But cocoa compatible html generation (Helper
mimics it) is really a bad trick IMHO.
if you have managed to find a stable automatic
way to translate from the cocoa webkit's html
format to a more human readable format that
displays the same, it would be good if this
script could be integrated SC on os x in a way
that it works more or less in the background.
It would be difficult to keep up with
modifications done and resaved from os x (which
will save it again in cocoa style, as far as I
know).
-a-
On 17 Dec 2008, at 23:34,
<<mailto:andersvi@xxxxxxxxxxxxx>mailto:andersvi@xxxxxxxxxxxxx><mailto:andersvi@xxxxxxxxxxxxx>andersvi@xxxxxxxxxxxxx
wrote:
"j" == jostM
<<<mailto:sc3@xxxxxxxx>mailto:sc3@xxxxxxxx><mailto:sc3@xxxxxxxx>sc3@xxxxxxxx>
writes:
A related question, which is just a matter of style, is the
apple-editor the reason why code-portions arent put inside nice
css'ed <pre> blocks as well?
j> I suppose because of syntax colorization. Indeed it would be
j> great if there were a way to have all code in a <pre> tag or a
j> <code> tag, if there were a way to get a browser to colorize it
j> then.
The coloring isn't a problem. afaik you can put as much bells'n
whistles you want (at least spans with colors etc) inside pre blocks as
well. Automatic translation would take some thinking though.
Ive run through all the html-files ive found inside Html with a sed
script, and looked at a few of them from some
SC_<<Help:w3m>Help:w3m><Help:w3m>Help:w3m
buffer, they
look much better now. Ill see if i can upload an archive to a webpage.
Check
<<http://www.notam02.no/~andersvi/SC-Help-files.tar.bz2>http://www.notam02.no/~andersvi/SC-Help-files.tar.bz2><http://www.notam02.no/~andersvi/SC-Help-files.tar.bz2>http://www.notam02.no/~andersvi/SC-Help-files.tar.bz2
in a while.
Im not sure how various developers generate the html which gets
included, but i guess a translation-script could be handy for others as
well. This script only substitutes the p-tags for now.
Using <pre>'s (difficult?) and changing the Helper class (easy) comes
later. See comments to begin with for applying to a directory-tree (ie
build//Help):
<rehtmlize>
I guess the files could be operated on 'in place', but im not too sure
about shell-programming in general, and especially escaping white-spaces
in file-names...
--------------------------------------------------
Andrea Valle
--------------------------------------------------
CIRMA - DAMS
Università degli Studi di Torino
-->
<<http://www.cirma.unito.it/andrea/>http://www.cirma.unito.it/andrea/><http://www.cirma.unito.it/andrea/>http://www.cirma.unito.it/andrea/
-->
<<http://www.myspace.com/andreavalle>http://www.myspace.com/andreavalle><http://www.myspace.com/andreavalle>http://www.myspace.com/andreavalle
-->
<<mailto:andrea.valle@xxxxxxxx>mailto:andrea.valle@xxxxxxxx><mailto:andrea.valle@xxxxxxxx>andrea.valle@xxxxxxxx
--------------------------------------------------
- La Repubblica promuove lo sviluppo della
cultura e la ricerca scientifica e tecnica.
- La Repubblica detta le norme generali
sull'istruzione ed istituisce scuole statali
per tutti gli ordini e gradi.
(Costituzione della Repubblica Italiana, art. 9 e 33)
--
.
_______________________________________________
sc-dev mailing list
info (subscription, etc.):
<http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml>http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml
archive:
<https://listarc.bham.ac.uk/marchives/sc-dev/>https://listarc.bham.ac.uk/marchives/sc-dev/
search:
<https://listarc.bham.ac.uk/lists/sc-dev/search/>https://listarc.bham.ac.uk/lists/sc-dev/search/
--------------------------------------------------
Andrea Valle
--------------------------------------------------
CIRMA - DAMS
Università degli Studi di Torino
--> <http://www.cirma.unito.it/andrea/>http://www.cirma.unito.it/andrea/
--> <http://www.myspace.com/andreavalle>http://www.myspace.com/andreavalle
--> <mailto:andrea.valle@xxxxxxxx>andrea.valle@xxxxxxxx
--------------------------------------------------
- La Repubblica promuove lo sviluppo della
cultura e la ricerca scientifica e tecnica.
- La Repubblica detta le norme generali
sull'istruzione ed istituisce scuole statali per
tutti gli ordini e gradi.
(Costituzione della Repubblica Italiana, art. 9 e 33)