Finally, it's done.
In the attached archive you'll find the following files: wine-faq.sgml -> Main sgml file faq-0.sgml \ faq-1.sgml |-> Content sgml files faq-2.sgml / faq.css -> CSS file for the FAQ index.html -> The output of docbook2html -d faq.dsl wine-faq.sgml authors.ent -> same as in documentation/, wasn't needed actually. faq.dsl -> Definition file for docbook. This is where the work went. I modify a few docbook definitions to match Dimitrie's layout. Not obvious without knowing LISP beforehand :)
Of course, if somebody chooses another layout, some of this will need adjustment. Or if we prefer something closer to "vanilla" docbook.
Dimitrie, the actual HTML code is rather ugly in it's source presentation, so don't hand-edit it :P Anyway, it's not meant to be hand-edited, that's what sgml and docbook are for. The layout is exactly what you already have, although with some small modifications to the layout the dsl file can be alot simpler.
Tony, you can begin the transition if Dimitrie likes it (and when you have the time to).
That's all for tonight.
Vincent
On November 10, 2002 11:25 pm, Vincent Béron wrote:
Dimitrie, the actual HTML code is rather ugly in it's source presentation, so don't hand-edit it :P Anyway, it's not meant to be hand-edited, that's what sgml and docbook are for. The layout is exactly what you already have, although with some small modifications to the layout the dsl file can be alot simpler.
Good stuff. Looked over it, looks good. I don't particularly like breaking the faq into different files, but that's minor.
The problem is of course that the .dsl files looks very...complicated :) It raises the bar quite a bit as compared to the HTML markup, but if people are so hot about SGML, so be it.
Tony, you can begin the transition if Dimitrie likes it (and when you have the time to).
I say we do this: 1. incorporate whatever changes people see necessary in the next few days 2. push the current HTML FAQ to WineHQ 3. start the HTML->SGML conversion
With these in mind: -- if you have suggestions, complaints, etc. please voice them now -- Jeremy, when can we get the FAQ on the site?
Dimitrie O. Paun a écrit:
On November 10, 2002 11:25 pm, Vincent Béron wrote:
Dimitrie, the actual HTML code is rather ugly in it's source presentation, so don't hand-edit it :P Anyway, it's not meant to be hand-edited, that's what sgml and docbook are for. The layout is exactly what you already have, although with some small modifications to the layout the dsl file can be alot simpler.
Good stuff. Looked over it, looks good. I don't particularly like breaking the faq into different files, but that's minor.
The problem is of course that the .dsl files looks very...complicated :) It raises the bar quite a bit as compared to the HTML markup, but if people are so hot about SGML, so be it.
The dsl file is not meant to be changed often. But it's still there that you need to change stuff to change the translation of docbook tags to HTML tags. It could be simplified (read: we could use more docbook default elements), but it would change a bit the layout of the FAQ. See my comments in faq.dsl for the purpose of each element, and try removing some to see if the result is still "good".
Tony, you can begin the transition if Dimitrie likes it (and when you have the time to).
I say we do this:
- incorporate whatever changes people see necessary in the next few days
- push the current HTML FAQ to WineHQ
- start the HTML->SGML conversion
With these in mind: -- if you have suggestions, complaints, etc. please voice them now
Actually, since it'll be converted from sgml to html, the layout complaints/improvements can come later: it will only minimally impact the sgml. I can (and probably will :) maintain the dsl file.
-- Jeremy, when can we get the FAQ on the site?
Vincent
Dimitrie O. Paun wrote:
On November 10, 2002 11:25 pm, Vincent Béron wrote:
Dimitrie, the actual HTML code is rather ugly in it's source presentation, so don't hand-edit it :P Anyway, it's not meant to be hand-edited, that's what sgml and docbook are for. The layout is exactly what you already have, although with some small modifications to the layout the dsl file can be alot simpler.
Good stuff. Looked over it, looks good. I don't particularly like breaking the faq into different files, but that's minor.
I have attached the sgml so that the faq is all in one file. One file or 100 files makes no real diference... So If you prefer only 1(big) file then I can do it this way.
The problem is of course that the .dsl files looks very...complicated :) It raises the bar quite a bit as compared to the HTML markup, but if people are so hot about SGML, so be it.
The thing that is nice about sgml is that you can get html, ps and pdf out of it that what makes it hot. If Vincent can work out a (pretty) dsl file that will run on my system we should be in good shape. We already have faq-plain.dsl that works good but does not have the prettys.
Tony, you can begin the transition if Dimitrie likes it (and when you have the time to).
I am working on it now... Status 3%. It should be ready by the end of next week, sooner if I get some real time to work on it.
I say we do this:
- incorporate whatever changes people see necessary in the next few days
- push the current HTML FAQ to WineHQ
- start the HTML->SGML conversion
I have not seen to many changes or requests for changes so I am just working off your url. <grin>
With these in mind: -- if you have suggestions, complaints, etc. please voice them now -- Jeremy, when can we get the FAQ on the site?
Once Vincent has worked out the dsl file we should have it as a target in the makefile. Vincent are you game for this?
On November 14, 2002 04:53 pm, Tony Lambregts wrote:
I have not seen to many changes or requests for changes so I am just working off your url. <grin>
I was hoping to have the FAQ on the site sooner rather than later, we've been busting our balls to finish it fast...
But if you started already translating it to SGML, let me know so I don't update it, etc. and cause problems.
Vincent Béron wrote:
Finally, it's done.
In the attached archive you'll find the following files: wine-faq.sgml -> Main sgml file faq-0.sgml \ faq-1.sgml |-> Content sgml files faq-2.sgml / faq.css -> CSS file for the FAQ index.html -> The output of docbook2html -d faq.dsl wine-faq.sgml authors.ent -> same as in documentation/, wasn't needed actually. faq.dsl -> Definition file for docbook. This is where the work went. I modify a few docbook definitions to match Dimitrie's layout. Not obvious without knowing LISP beforehand :)
Of course, if somebody chooses another layout, some of this will need adjustment. Or if we prefer something closer to "vanilla" docbook.
Dimitrie, the actual HTML code is rather ugly in it's source presentation, so don't hand-edit it :P Anyway, it's not meant to be hand-edited, that's what sgml and docbook are for. The layout is exactly what you already have, although with some small modifications to the layout the dsl file can be alot simpler.
Tony, you can begin the transition if Dimitrie likes it (and when you have the time to).
That's all for tonight.
I have been fighting with trying to get your sample built on my system. The end point for me seems to be that in order to use your faq.dsl I need docbook DTD 4.2. RedHat 7.2 has Docbook 3.0 through 4.1 but 4.1 just does not cut it.
jade:../faq.dsl:50:24:E: reference to undefined variable "$generate-article-lot-list$"
The sgml tools site has only 3.0/2
So I feel very THICK and ned some enlightenment on what direction to take either.
1) It seems pointless to rely on something (docBook 4.2 DTD) that is difficult to get, so no one will use it so, no one will maintain the FAQ.
2) I am THICK and I it will be quickly apparent what I should do once I have more informatioin.
Tony Lambregts a écrit:
I have been fighting with trying to get your sample built on my system. The end point for me seems to be that in order to use your faq.dsl I need docbook DTD 4.2. RedHat 7.2 has Docbook 3.0 through 4.1 but 4.1 just does not cut it.
jade:../faq.dsl:50:24:E: reference to undefined variable "$generate-article-lot-list$"
The sgml tools site has only 3.0/2
So I feel very THICK and ned some enlightenment on what direction to take either.
- It seems pointless to rely on something (docBook 4.2 DTD) that is
difficult to get, so no one will use it so, no one will maintain the FAQ.
Silly me, not thinking about others. It runs fine with docbook 3.1 (modify the doctype at top of wine-faq.sgml) if you remove the articleinfo pair (but you can keep the title).
- I am THICK and I it will be quickly apparent what I should do once I
have more informatioin.
You're NOT thick! It's just that I do things here (on my machine), and I don't always check if it would work on other machines.
Vincent
Vincent Béron wrote:
Tony Lambregts a écrit:
I have been fighting with trying to get your sample built on my system. The end point for me seems to be that in order to use your faq.dsl I need docbook DTD 4.2. RedHat 7.2 has Docbook 3.0 through 4.1 but 4.1 just does not cut it.
jade:../faq.dsl:50:24:E: reference to undefined variable "$generate-article-lot-list$"
The sgml tools site has only 3.0/2
So I feel very THICK and ned some enlightenment on what direction to take either.
- It seems pointless to rely on something (docBook 4.2 DTD) that is
difficult to get, so no one will use it so, no one will maintain the FAQ.
Silly me, not thinking about others. It runs fine with docbook 3.1 (modify the doctype at top of wine-faq.sgml) if you remove the articleinfo pair (but you can keep the title).
- I am THICK and I it will be quickly apparent what I should do once
I have more informatioin.
You're NOT thick! It's just that I do things here (on my machine), and I don't always check if it would work on other machines.
Vincent
When I made the suggested changes I still get the same error...
[tony@tony documentation]$ db2html -d ../faq.dsl wine-faq.sgml output is wine-faq Using catalogs: /etc/sgml/sgml-docbook-3.1.cat Using stylesheet: ../faq.dsl Working on: /usr/local/src/wine/documentation/wine-faq.sgml jade:../faq.dsl:50:24:E: reference to undefined variable "$generate-article-lot-list$"
No ouput....
-
Dimitrie O. Paun -
Tony Lambregts -
Vincent Béron