Re: New draft of manual style
On Saturday 24 August 2002 05.15, Joshua Slive wrote: As for the new look, I'm a big -1 to it! The wacky design that Joshua did was so much better. It looked much more modern. This new look is plain ugly (not very constructive criticism, I know.) I'll take some time to criticize it in detail later on today... :-) I've only had time to look through the index.html page so far. Here are some problems I see with it... Contains a new draft of the proposed new manual style. This one is fully generated using xslt, so all the xml files should be converted. Then the meta tag for generator is wrong. The html source wasn't generated by Tidy - so they shouldn't be blamed :-) Don't lock the main table's width to 600. If you have a big font things begin to wrap much too early. I'd suggest that you don't use any width at all. The alt value for pixel.gif should be , not .. Actually, for this page I would remove the pixel.gif part completely. Use th for table headers! A) that's what they're for :-) B) It's much easier to make changes to their styles later on C) Some screen readers handle the semantics of the page much better if you use correct table tags. That's what I found after a quick perusal, I'll try to spend some more time on this later on... -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: New draft of manual style
On Saturday 24 August 2002 15.30, Joshua Slive wrote: Hmmm... The index.html page has not been changed because it is not in xml. You need to look at some of the pages that have xml source in order to see the new format. Actually, I was making two seperate statements :-) Yes, I've looked at several pages in the docs hierarchy. And No, I don't like the new layout - I even prefer the original look. But I thought I might as well begin my scrutinization from the first page - even though it doesn't have that much to do with the rest of the layout. The whole site should look good and be useful! Sorry if I my reply was a bit muddled :-) -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: wacky docs look - take two
On Saturday 10 August 2002 05.03, Joshua Slive wrote: - Is this the right overall direction? +1! - Is it too flashy/complicated? I don't find it too flashy. The one thing I would change, is to put the menu box on the right on the left side instead. I think that would work better for people people who haven't got that high resolution. Then they won't have to scroll to see the main information. Otherwise, I have only small, cosmetic things to complain about: My biggest gripe is that the boxes for examples/warnings/etc always ought to be the same width (preferably they should use the same width as the ordinary text.) I think the header part could be smaller on sub pages. Why waste valuable screen space on something that you know anyhow :-) The Maintained by... footer should be aligned with the main information text box. If one doesn't move the menu box, then the maintain message ought to be right aligned. - Does it work in everybody's various browsers? (It is supposed to work at least back to Netscape 4, but I haven't tested it.) I've tried it in Konqeuror, Links, Lynx, and Galeon. It seems to work in them all. If people like it, what the process be for adopting it? Should we go ahead and do it now, and fix up any problems later. I'd say; go for it now. Or at least very soon. You might want to take a week or two to gather input, before applying it for real. -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: cvs commit: httpd-2.0/docs/manual/style modulesynopsis.dtd
On Mon, 11 Mar 2002, Joshua Slive wrote: Added %inlinetags; to default (some docs uses em in default) Could you reverse that please. Sure! The reason I added em was that some docs use this tag for defaults that are taken from different modules/directives. To allow for such cases, I propose that we allow directive with in default. That would allow links to the module where the directive in question is defined, which looks nice... -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Swedish xml translation
On Fri, 8 Mar 2002, Joshua Slive wrote: The problem with make is that we would need to list each xml file in the makefile. We're trying to reduce that kind of duplication. No, you don't. How about; .SUFFIXES : .html .xml vpath = ../mod/ xmlfiles := ../mod/*.xml htmlfiles := $(patsubst %.xml,%.html,$(xmlfiles)) all: $(htmlfiles) %.html : %.xml XalanTransform $ ./manual.xsl $@ Works great - well, at least as proof-of-concept :-) -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Swedish xml translation
On Wed, 6 Mar 2002, Joshua Slive wrote:
3. Have some funky build process tranlate .en.xml to .html.en while doing
the XSLT. The build process I'm using at the moment is simply:
for file in `ls ../mod/*.xml | sed s|../mod/||g | sed s/.xml//g`
do
echo $file
${JAVA_HOME}/bin/java -classpath $CLASSPATH
org.apache.xalan.xslt.Process \
-IN ../mod/$file.xml -XSL manual.xsl -OUT ../mod/$file.html
done
But this will get more complicated in the future as we add more directories,
etc. I had hoped to use Ant, which has some very fancy automation features,
but as I've said, it is crashing on me at the moment.
Unless you feel like leading the charge on 2 or 3, I suggest that you stick
with 1 for now so that you can get on with your translations.
Number three is very easy to do. Especially if we aren't going to use ant.
It would be easy with ant as well if we allow the usage of
filemapper=regexp, then we could do something like;
mapper type=regexp from=^(.*)\.(.*)\.xml$$ to=\1.xml\2/
But since type=regexp requires extra libs I'm not sure if that's a good
thing.
I've got to the point were ant isn't crashing anymore. It seems that the
problem is resetting the language variable between runs, if you use;
xsl:variable name=languageen/xsl:variable
It works. I haven't had the time to figure out a good, dynamic replacement
that works with ant. So, I haven't made any changes to settings.xsl that I
feel are worthy of putting into the CVS :-)
I guess the question is; should we use ant or not? I think good ol' make
would be a better alternative for now...
--
.-.
| Patrik Grip-Jansson |
| Ringen 4B |..
| 78444 Borlänge .--'' http://gnulix.com/ `-.
| Sweden | All views and opinions are my own, |
`--| PH:+46(0)24382823 PW:+46(0)707354360 |
`--'
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Re: New version of manual.xsl
On Tue, 5 Mar 2002, Joshua Slive wrote: Sorry, this might be a pain for you, but I'm going to have to insist on diffs for this stuff. Otherwise, it is almost impossible to determine what has changed from one version to another. Not a problem. I should have thought of it myself! I guess I'll have to try to get CVS access later on, so this process is easier. Here are the diffs. There's nothing new in this version. Well, time to track down why Mozilla isn't working with the new style... -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' *** en.xml.old Sun Mar 3 16:32:57 2002 --- en.xml Wed Mar 6 02:29:10 2002 *** *** 2,8 !-- English -- messages ! message name=seealsoSee also/message message name=descriptionDescription/message message name=apachemoduleApache Module/message message name=statusStatus/message --- 2,8 !-- English -- messages ! message name=seealsoSee also /message message name=descriptionDescription/message message name=apachemoduleApache Module/message message name=statusStatus/message *** *** 14,17 message name=overrideOverride/message message name=statusStatus/message message name=moduleModule/message ! /messages \ No newline at end of file --- 14,24 message name=overrideOverride/message message name=statusStatus/message message name=moduleModule/message ! message name=nodirectiveThis module provides no directives./message ! message name=apachedocalt[APACHE DOCUMENTATION]/message ! message name=apachehttpserverApache HTTP Server Version 2.0/message ! message name=indexIndex/message ! message name=homeHome/message ! message name=directivesDirectives/message ! message name=directiveDirective/message ! /messages *** ./sv.xml.oldSun Mar 3 16:32:57 2002 --- sv.xml Wed Mar 6 02:27:47 2002 *** *** 4,16 messages message name=seealsoSe även/message message name=descriptionBeskrivning/message ! message name=apachemoduleApache Modul/message message name=statusStatus/message ! message name=moduleidentifierModul ID/message message name=compatibilityKompatibilitet/message message name=syntaxSyntax/message ! message name=defaultStandardvärde/message message name=contextKontext/message ! message name=overrideOverride/message message name=moduleModul/message ! /messages \ No newline at end of file --- 4,24 messages message name=seealsoSe även/message message name=descriptionBeskrivning/message ! message name=apachemoduleApachemodul/message message name=statusStatus/message ! message name=moduleidentifierModulnamn/message message name=compatibilityKompatibilitet/message message name=syntaxSyntax/message ! message name=defaultFörvaltvärde/message message name=contextKontext/message ! message name=overrideIstället för/message ! message name=statusStatus/message message name=moduleModul/message ! message name=nodirectiveDen här modulen har inga kommandon./message ! message name=apachedocalt[APACHE DOKUMENTATION]/message ! message name=apachehttpserverApache HTTP-server version 2.0/message ! message name=indexIndex/message ! message name=homeHem/message ! message name=directivesKommandon/message ! message name=directiveKommando/message ! /messages *** manual.xsl.old Wed Mar 6 02:29:45 2002 --- manual.xsl Wed Mar 6 02:30:57 2002 *** *** 25,32 body blockquote div align=center ! img src=../images/sub.gif alt=[APACHE DOCUMENTATION] / ! h3Apache HTTP Server Version 2.0/h3 /div h1 align=centerxsl:value-of select=$messages/[EMAIL PROTECTED]'apachemodule']/ xsl:value-of select=name//h1 !-- Description and module-headers -- --- 25,36 body blockquote div align=center ! img src=../images/sub.gif width=600 height=62 ! xsl:attribute name=alt ! xsl:value-of select=$messages/[EMAIL PROTECTED]'apachedocalt']/ ! /xsl:attribute ! /img ! h3xsl:value-of select=$messages/[EMAIL PROTECTED]'apachehttpserver']//h3 /div h1 align=centerxsl:value-of select=$messages/[EMAIL PROTECTED]'apachemodule']/ xsl:value-of select=name//h1 !-- Description and module-headers -- *** *** 52,58 !-- Summary of module features/usage (1 to 3 paragraphs, optional) -- xsl:if test=summary ! h2Summary/h2 xsl:apply-templates select=summary/ /xsl:if --- 56,62 !-- Summary of module features/usage (1 to 3 paragraphs, optional) -- xsl:if test=summary ! h2xsl:value-of select=$messages/[EMAIL PROTECTED]'summary']//h2 xsl:apply-templates select=summary/ /xsl:if *** *** 68,74
RE: New version of manual.xsl
On Tue, 5 Mar 2002, Joshua Slive wrote: Cool, thanks. For the future, context diffs (diff -u) are much better. I did use context diffs, that is diff -c. With the u flag you'll get unified diffs. Which, I gather is what you're after. I'll wait 'till you have a chance to look at the other stuff before I commit this. Actually I think this is version is pretty suitable for a commit. It has got all words localized, which the one in the repository hasn't. In addition, if you have a chance, it would be great if you could look at the spacing problem (extra space after directive/directive and module/module in the html output). Yes, I saw that when I tinkered around with a Swedish translation I just did. I think I know what the problem is. I'll try to fix it with-in the hour. As far as commit access, as long as you hang around for a little while and keep contributing, that will come. Actually I think I had access some 12-18 months ago. Not that I really submitted anything. But I'm most certainly in no hurry! -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: dtd for httpd-docs
On Tue, 5 Mar 2002, Joshua Slive wrote: - Where should it go? manual/style/, manual/mod/, ... ? I think it fits nicely in manual/style/, along with the xsl files. - Should we use a PUBLIC or a SYSTEM identifier. SYSTEM is easier to setup, because we don't need to much with CATALOGs, but I'm not sure what the right thing is. I don't really think there is a right thing here. I'd say; go with SYSTEM. As I've mentioned, I really don't know what I'm doing with DTDs, so any comments will be appreciated. I'll give you some, as soon as I get to play around with this new DTD-toy :-) -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: New version of manual.xsl
On Tue, 5 Mar 2002, Joshua Slive wrote: Yep, you're way up on me again. You do indeed have an account, but it doesn't look like you have commit access to anything. Can you refresh my memory about this? Well, I was about to start translating the 1.3 docs into Swedish and generally help out in some other ways (mainly editing). Then I got ill for almost a year, during which I didn't do anything at all. I hardly even managed to lurk. The next time I had time to check out my account was after the security problems. My account seemed to be locked out. Since I wasn't sure how much time I could spend on the project, I didn't bother anyone about the account. However, now I got quite a lot of time on my hands. Which I'll try to spend a large chunk of on the documentation project... -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: New version of manual.xsl
On Tue, 5 Mar 2002, Joshua Slive wrote:
Actually I think this is version is pretty suitable for a commit. It has
got all words localized, which the one in the repository hasn't.
Ok. I'll try to do it later.
I managed to fix a couple of the extra white space problems. I've included
a diff, it's against the old file from the repository.
--
.-.
| Patrik Grip-Jansson |
| Ringen 4B |..
| 78444 Borlänge .--'' http://gnulix.com/ `-.
| Sweden | All views and opinions are my own, |
`--| PH:+46(0)24382823 PW:+46(0)707354360 |
`--'
--- manual.xsl.old Wed Mar 6 04:10:52 2002
+++ manual.xsl Wed Mar 6 04:11:49 2002
@@ -28,10 +28,10 @@
img src=../images/sub.gif alt=[APACHE DOCUMENTATION] /
h3Apache HTTP Server Version 2.0/h3
/div
- h1 align=centerxsl:value-of select=$messages/[EMAIL
PROTECTED]'apachemodule']/ xsl:value-of select=name//h1
+ h1 align=centerxsl:value-of select=$messages/[EMAIL
PROTECTED]'apachemodule']/nbsp; xsl:value-of select=name//h1
!-- Description and module-headers --
- table bgcolor=#cc cellpadding=0 cellspacing=1trtd
-table bgcolor=#ff
+ table width=100% bgcolor=#cc cellpadding=0
cellspacing=1trtd
+table width=100% bgcolor=#ff
trtd valign=topspan class=helpxsl:value-of
select=$messages/[EMAIL PROTECTED]'description']/:/span /td
tdxsl:apply-templates select=description//td/tr
trtda class=help href=module-dict.html#Statusxsl:value-of
select=$messages/[EMAIL PROTECTED]'status']/:/a /td
@@ -41,7 +41,7 @@
tdxsl:value-of select=identifier//td/tr
/xsl:if
xsl:if test=compatibility
- trtda class=help href=module-dict.html#Compatibility
+ trtd valign=top align=lefta class=help
href=module-dict.html#Compatibility
xsl:value-of select=$messages/[EMAIL
PROTECTED]'compatibility']/:/a /td
tdxsl:apply-templates select=compatibility//td
/tr
@@ -176,7 +176,7 @@
name={$lowername}Directive/a/h2
!-- Directive header --
-table bgcolor=#cc border=0 cellspacing=0 cellpadding=1
+table width=100% bgcolor=#cc border=0 cellspacing=0
cellpadding=1
trtd
table bgcolor=#ff width=100%
trtdstrongxsl:value-of select=$messages/[EMAIL
PROTECTED]'description']/: /strong/td
@@ -206,7 +206,7 @@
/xsl:if
/td/tr
xsl:if test=compatibility
-trtda class=help href=directive-dict.html#Compatibility
+trtd valign=top align=lefta class=help
href=directive-dict.html#Compatibility
xsl:value-of select=$messages/[EMAIL
PROTECTED]'compatibility']/:/a /td
tdxsl:value-of select=compatibility//td/tr
/xsl:if
@@ -242,7 +242,7 @@
xsl:template match=example
blockquote
- table cellpadding=10trtd bgcolor=#ee
+ table width=100% cellpadding=10trtd bgcolor=#ee
xsl:apply-templates select=title mode=print/
codexsl:apply-templates//code
/td/tr/table
@@ -256,7 +256,7 @@
xsl:template match=note
blockquote
- tabletrtd
+ table width=100%trtd
xsl:choose
xsl:when test=@type='warning'
xsl:attribute name=bgcolor#ffe5f5/xsl:attribute
@@ -297,11 +297,7 @@
/xsl:template
xsl:template match=module
-code
- a href={.}.htmlxsl:value-of select=.//a
-/code
-xsl:if test=parent::modulelist
- xsl:if test=not(position()=last()), /xsl:if
+codea href={.}.htmlxsl:value-of select=.//a/codexsl:if
test=parent::modulelistxsl:if test=not(position()=last()), /xsl:if
/xsl:if
/xsl:template
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
RE: Swedish xml translation
On Wed, 6 Mar 2002, Joshua Slive wrote: I think it should be mod_suexec.xml.sv. I know this is a pain for windows The last extension is the filetype users. Wish that it was only a problem for Windows users. Since most browsers use the extension for as well, you wouldn't be able to transform the file directly, ie mozilla file://mod_this_or_that.xml. But the transformed html MUST look like mod_suexec.html.sv in order for multiviews to work, so it makes sense to parallel that in the xml. It's a tough choice between uniformity and convenience... -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: New version of manual.xsl
On Wed, 6 Mar 2002, Joshua Slive wrote: I changed a few things: I got rid of the 100% table widths because they don't render properly in MSIE (extend past end of page). I'd guess this has to do with the table in blockquote hack that we are currently using. OK, the reason I added that was that it looked a bit ugly when different sized boxes where close together. Not really a major issue though, I'll guess we can do something about that later on :-) Now, the biggest outstanding issue is, is there any way to make this work more consistently in the different XSLT engines? The ones I've tried so far are Mozilla, Xalan-C++, and xsltproc (from Gnome's XML/XSLT suite.) They all produce correct results from the current stylesheet. Does anyone know of an engine that causes problems? -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Swedish xml translation
On Wed, 6 Mar 2002, Joshua Slive wrote: Wish that it was only a problem for Windows users. Since most browsers use the extension for as well, you wouldn't be able to transform the file directly, ie mozilla file://mod_this_or_that.xml. I hadn't considered that. H Actually, I think you are wrong in general. If the browser is accessing the file through the webserver, it should be using the Content-Type delivered by the webserver. I agree, when accessing through a webserver they should use the mime type, but... Accessing through the filesystem is another story. ...that's what I meant (and hence the example with a file:// URL). I guess I didn't express myself clearly. -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: dtd for httpd-docs
On Mon, 4 Mar 2002, Brad Miller wrote:
I also attached the template. This is a very rough draft and needs more
refinement. For now this validates and can be used as a template with the
new dtd attached.
I liked the template and the DTD is really coming along - nice work!
~~Or note type=warning? Either way is fine with me. You may
~~want to check the Docbook DTD to see how they do it. One that might be
~~particularly useful in apache is securitywarning or something like that.
I added securitywarning you can place any text or formating in it. Do we
need any attributes for this?
I've also implemented this in the xsl file. I've added it as an type
attribute to the note tag, as suggested by Joshua. At the moment the
type attribute can be; plain, warning, and securitywarning. Where plain is
the default.
I added language. I don't really have any rules for language. And I am not
really following how you are switching languages here.
Are you pulling information from another file if the stylesheet sees the
language tag it will find whatever xml file for that language you specify
with an attribute and include that? I guess I really don't understand how
the language conversion works.
Yes, the language switching works more or less as you assumed. At the
beginning of the transform we set language to a default value of en. If
there is a language tag in directivesynopsis, we take the value from
that node instead. Then the transform does a document() to pull in some
text nodes from the appropriate {$language}.xml file. The technique is
right out of the xsl specification, where it is used as an example of how
to use xsl:message.
Can someone give me a list of attributes for this if that is how it is done?
I also need to know where the language attribute will be used if anywhere
other than directivesynopsis.
I've been thinking about this. And I can't see any reason to have it
anywhere else. I'm starting to think that it might be better to use
directivesyopsis language=en rather than having the language tag.
Lastly, do we want to stick with a DTD or should we be using a schema?
I don't really have an opinion on this because I know dtd's better but
schemas are more rubust.
I'm also more comfortable with DTD:s. So I suggest we stick with them for
the time being. The rule set we are trying to enforce isn't all that
complicated, nor would I assume that all the rules are really that strict
either. I don't think it would be the end of the world, should someone
put four paragraphs in a summary.
My belief is that the most important part is that we shouldn't impose
arbitrary rules on the authors, as long as it doesn't make the
transformation process too unruly (read impossible :-)
Converting to a schema at this point wouldn't take much effort.
There are a couple of good DTD-Schema utilities out there (out there,
being Freshmeat.) Why not keep to our DTD, and use some such utility when
the need arises? No need to be bleeding edge :-)
--
.-.
| Patrik Grip-Jansson |
| Ringen 4B |..
| 78444 Borlänge .--'' http://gnulix.com/ `-.
| Sweden | All views and opinions are my own, |
`--| PH:+46(0)24382823 PW:+46(0)707354360 |
`--'
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
New version of manual.xsl
Here's a newer version of manual.xsl. There are still some problems with Mozilla. Works great in Xalan, xsltproc, and so on. I'll try to find the source of these problems later on tonight. This version localizes all string (I hope.) It also adds two new types to note; warning and securitywarning. Right now the only difference is that the background color gets a bit red. -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' ?xml version=1.0 encoding=ISO-8859-1? !DOCTYPE xsl:stylesheet [ !ENTITY nbsp #160; ] xsl:stylesheet version=1.0 xmlns:xsl=http://www.w3.org/1999/XSL/Transform; xmlns=http://www.w3.org/TR/xhtml1/strict; !-- Constants used for case translation -- xsl:variable name=lowercase select='abcdefghijklmnopqrstuvwxyz' / xsl:variable name=uppercase select='ABCDEFGHIJKLMNOPQRSTUVWXYZ' / !-- Defined parameters (overrideable) -- xsl:param name=relative-path select='.'/ !-- Macros, variables, and stuff for the localization -- !-- English is the default language -- xsl:variable name=language xsl:if test=modulesynopsis/language xsl:value-of select=modulesynopsis/language/ /xsl:if xsl:if test=not(modulesynopsis/language)en/xsl:if /xsl:variable !-- Read the localized messages from the specified language file -- xsl:variable name=messages select=document(concat($language, '.xml'))/messages/ /xsl:stylesheet ?xml version=1.0 encoding=ISO-8859-1? !-- English -- messages message name=seealsoSee also /message message name=descriptionDescription/message message name=apachemoduleApache Module/message message name=statusStatus/message message name=moduleidentifierModule Identifier/message message name=compatibilityCompatibility/message message name=syntaxSyntax/message message name=defaultDefault/message message name=contextContext/message message name=overrideOverride/message message name=statusStatus/message message name=moduleModule/message message name=nodirectiveThis module provides no directives./message message name=apachedocalt[APACHE DOCUMENTATION]/message message name=apachehttpserverApache HTTP Server Version 2.0/message message name=indexIndex/message message name=homeHome/message message name=directivesDirectives/message message name=directiveDirective/message /messages ?xml version=1.0 encoding=ISO-8859-1? !-- Swedish -- messages message name=seealsoSe även/message message name=descriptionBeskrivning/message message name=apachemoduleApache Modul/message message name=statusStatus/message message name=moduleidentifierModule Identifier/message message name=compatibilityCompatibility/message message name=syntaxSyntax/message message name=defaultDefault/message message name=contextContext/message message name=overrideOverride/message message name=statusStatus/message message name=moduleModul/message message name=nodirectiveThis module provides no directives./message message name=apachedocalt[APACHE DOKUMENTATION]/message message name=apachehttpserverApache HTTP Server Version 2.0/message message name=indexIndex/message message name=homeHem/message message name=directivesDirectives/message message name=directiveDirective/message /messages?xml version=1.0 encoding=ISO-8859-1? !DOCTYPE xsl:stylesheet [ !ENTITY nbsp #160; ] xsl:stylesheet version=1.0 xmlns:xsl=http://www.w3.org/1999/XSL/Transform; xmlns=http://www.w3.org/TR/xhtml1/strict; !-- Include constants, variables, and macros -- xsl:import href=settings.xsl / xsl:output method=html encoding=iso-8859-1 indent=yes/ !-- Process an entire document into an HTML page -- xsl:template match=modulesynopsis html head xsl:comment X This file is generated from xml source: DO NOT EDIT X /xsl:comment xsl:apply-templates select=meta/ titlexsl:value-of select=name/ - Apache HTTP Server/title link rel=stylesheet type=text/css href=../style/manual.css / /head body blockquote div align=center img src=../images/sub.gif width=600 height=62 xsl:attribute name=alt xsl:value-of select=$messages/[EMAIL PROTECTED]'apachedocalt']/ /xsl:attribute /img h3xsl:value-of select=$messages/[EMAIL PROTECTED]'apachehttpserver']//h3 /div h1 align=centerxsl:value-of select=$messages/[EMAIL PROTECTED]'apachemodule']/ xsl:value-of select=name//h1 !-- Description and module-headers -- table bgcolor=#cc cellpadding=0 cellspacing=1trtd table bgcolor=#ff trtd valign=topspan class=helpxsl:value-of select=$messages/[EMAIL PROTECTED]'description']/:/span /td
Re: Another XML question
On Sat, 2 Mar 2002, Joshua Slive wrote: In mod_include I hvae a link that looks like: a href=mod_cgi.htmlCGI/a What is the correct way to do this with the module tag? I thought about that a little, and I think it is right the way it is. A module tag designates the name of a module. If you want to link to a module without using its name, an ordinary link is correct IMHO. Is really a good idea to use a html href? If we want to convert the xml into something else (pdf, clay tables, what ever) it's probably easier if we were to use some of our own markups. -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: New xsl template
Ooops, I included the wrong version of manual.xls.
note has gotten a new selector type. So far the only acceptable value
is warning. note type=warning will get you a more reddish
background, than the usual notes.
To parapgrase Crocodile Dundee; Yes, it looks like shite, but you can use!
I'll try to get it better next time...
--
.-.
| Patrik Grip-Jansson |
| Ringen 4B |..
| 78444 Borlänge .--'' http://gnulix.com/ `-.
| Sweden | All views and opinions are my own, |
`--| PH:+46(0)24382823 PW:+46(0)707354360 |
`--'
?xml version=1.0 encoding=ISO-8859-1?
!DOCTYPE xsl:stylesheet [ !ENTITY nbsp #160; ]
xsl:stylesheet version=1.0
xmlns:xsl=http://www.w3.org/1999/XSL/Transform;
xmlns=http://www.w3.org/TR/xhtml1/strict;
!-- Include constants, variables, and macros --
xsl:import href=settings.xsl /
xsl:output method=html encoding=iso-8859-1 indent=yes/
!-- Process an entire document into an HTML page --
xsl:template match=modulesynopsis
html
head
xsl:comment
X
This file is generated from xml source: DO NOT EDIT
X
/xsl:comment
xsl:apply-templates select=meta/
titlexsl:value-of select=name/ - Apache HTTP Server/title
link rel=stylesheet type=text/css href=../style/manual.css /
/head
body
blockquote
div align=center
img src=../images/sub.gif alt=[APACHE DOCUMENTATION] /
h3Apache HTTP Server Version 2.0/h3
/div
h1 align=centerxsl:value-of select=$messages/[EMAIL
PROTECTED]'apachemodule']/ xsl:value-of select=name//h1
!-- Description and module-headers --
table bgcolor=#cc cellpadding=0 cellspacing=1trtd
table bgcolor=#ff
trtd valign=topspan class=helpxsl:value-of
select=$messages/[EMAIL PROTECTED]'description']/:/span /td
tdxsl:apply-templates select=description//td/tr
trtda class=help href=module-dict.html#Statusxsl:value-of
select=$messages/[EMAIL PROTECTED]'status']/:/a /td
tdxsl:value-of select=status//td/tr
xsl:if test=identifier
trtda class=help
href=module-dict.html#ModuleIdentifierxsl:value-of select=$messages/[EMAIL
PROTECTED]'moduleidentifier']/:/a /td
tdxsl:value-of select=identifier//td/tr
/xsl:if
xsl:if test=compatibility
trtda class=help href=module-dict.html#Compatibility
xsl:value-of select=$messages/[EMAIL
PROTECTED]'compatibility']/:/a /td
tdxsl:apply-templates select=compatibility//td
/tr
/xsl:if
/table
/td/tr/table
!-- Summary of module features/usage (1 to 3 paragraphs, optional) --
xsl:if test=summary
h2Summary/h2
xsl:apply-templates select=summary/
/xsl:if
xsl:if test=seealso
pstrongxsl:value-of select=$messages/[EMAIL
PROTECTED]'seealso']//strong/p
ul
xsl:for-each select=seealso
lixsl:apply-templates//li
/xsl:for-each
/ul
/xsl:if
!-- Index of directives, automatically generated from
directivesynopsis/name --
h2Directives/h2
xsl:if test=directivesynopsis
ul
xsl:for-each select=directivesynopsis
xsl:sort select=name/
xsl:variable name=name
xsl:value-of select=name/
/xsl:variable
xsl:variable name=lowername
select=translate($name, $uppercase, $lowercase) /
xsl:if test=not(@location)
lia href=#{$lowername}xsl:value-of select=name//a/li
/xsl:if
xsl:if test=./@location
xsl:variable name=location
xsl:value-of select=./@location/
/xsl:variable
xsl:variable name=lowerlocation
select=translate($location, $uppercase, $lowercase) /
lia href={$lowerlocation}.html#{$lowername}xsl:value-of
select=name//a/li
/xsl:if
/xsl:for-each
/ul
/xsl:if
xsl:if test=not(directivesynopsis)
pThis module provides no directives./p
/xsl:if
!-- Sections of documentation about the module as a whole --
xsl:apply-templates select=section/
hr /
!-- Directive documentation --
xsl:apply-templates select=directivesynopsis
xsl:sort select=name/
/xsl:apply-templates
!-- Page footer --
h3 align=centerApache HTTP Server Version 2.0/h3
a href=./img src=../images/index.gif alt=Index //a
a href=../img src=../images/home.gif alt=Home //a
/blockquote
/body
/html
/xsl:template !-- /modulesynopsis --
!-- Subsections: get a lower level heading --
xsl:template match=section/section
xsl:variable name=href
xsl:value-of select=@id/
/xsl:variable
!-- Section heading --
xsl:if test=@id
h3a name={$href}xsl:apply-templates select=./title
mode=print//a/h3
/xsl:if
xsl:if test=not(@id)
h3xsl:apply-templates select=./title mode=print//h3
/xsl:if
!-- Section body --
xsl:apply-templates/
/xsl:template
!-- Process a documentation section
XML/XSLT/And so on...
I was toying around with manual.xls a bit. I tried running it through the C++ versions of xerces and xalan, and I discovered that there are some small problems with the transforms. I think I've ironed out the problems, and they still seems to be working with the usual browsers. Secondly, I was thinking; wouldn't it be a good idea to internationalize manual.xsl? What few words there are could easily be applied on the fly. Thirdly, the html-output isn't all that nice looking. It's a mixture of HTML versions and techniques. Why not consolidate it all to a good solid CSS/XHTML fundation? While still making sure that it is readable/accesible on legacy browsers. If no one objects, I wouldn't mind fixing up manual.xls. I think we need to discuss the choosen XML markup keywords a bit further. How to use it in text, how to validate it, how to translate it (for various output sources). I guess this ties in with the discussions earlier on. -- .-. | Patrik Grip-Jansson | | Ringen 4B |.. | 78444 Borlänge .--'' http://gnulix.com/ `-. | Sweden | All views and opinions are my own, | `--| PH:+46(0)24382823 PW:+46(0)707354360 | `--' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: perl guru: mod_rewrite example
On Fri, 1 Feb 2002, Joshua Slive wrote:
Does some kind perl guru out there want to look at
http://bugs.apache.org/index.cgi/full/9686
see if this person makes sense and suggest an alternative.
He's right, and the proposed fix looks good. However, since we're redoing
the script, we might as well fix some other stuff...
The following script adds some error checking and allows comments on the
data rows (so that it works with the example map.txt). One could remove
the parenthesis in the if:s, but I guess this isn't a round of golf :-)
Anyhow, here is my proposal for a new txt2dbm:
#!/path/to/bin/perl
##
## txt2dbm -- convert txt map to dbm format
##
use NDBM_File;
use Fcntl;
($txtmap, $dbmmap) = @ARGV;
open(TXT, $txtmap) or die Couldn't open $txtmap!\n;
tie (%DB, 'NDBM_File', $dbmmap,O_RDWR|O_TRUNC|O_CREAT, 0644) or die Couldn't
create $dbmmap!\n;
while (TXT) {
next if (/^\s*#/ or /^\s*$/);
$DB{$1} = $2 if (/^\s*(\S+)\s+(\S+)/);
}
untie %DB;
close(TXT);
--
.-.
| Patrik Grip-Jansson |
| Ringen 4B |..
| 78444 Borlänge .--'' http://gnulix.com/ `-.
| Sweden | All views and opinions are my own, |
`--| PH:+46(0)24382823 PW:+46(0)707354360 |
`--'
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
