Hi all,

>> PDFs are often downloaded, so they should keep their human-readable names. 
>> Here again, you only have to change the name once: when you are satisfied 
>> with your (final) build and ready to upload. It takes seconds.

> IMO, the manual work must be replaced with scripts as much as possible.
> If we need human readable names, let's have them inside the docs sources
> and adjust the build scripts accordingly. It would also allow the author
> to properly name its output instead of leaving it up to the webmaster.

This is worth studying, though it's probably not going to be trivial. We have 
to find a way to store the file name inside the document:

1) without invalidating the DocBook format;
2) without it showing up inside the document text;
3) and in such a way that the master build script (or a dedicated script) can 
pick it up and apply it to the resulting file (but only for PDF and possibly 
monohtml as well).

(1) and (2) are easy enough; (3) might require some serious work.

> Just for the record, all the native language document names existing on
> the old site were replaced with English ones on the new site,

Yep, this was a very bad move that added to our problems. Or rather, to those 
of our users. In one blow, this has rendered all the hyperlinks worldwide to 
non-English Firebird PDFs on our site worthless.

> as neither the site team nor myself speak all the supported languages at once 
> ;-)

You don't have to speak a language in order to preserve an existing filename!

Anyway, I'll bring up this foreign-file-naming business up again later. There's 
another side to it as well: I find it utterly disrespectful that e.g. a French 
document with a French title should be downloaded under an English file name 
with -fr appended - without any technical necessity.


Paul Vinkenoog

------------------------------------------------------------------------------
All of the data generated in your IT infrastructure is seriously valuable.
Why? It contains a definitive record of application performance, security 
threats, fraudulent activity, and more. Splunk takes this data and makes 
sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-d2d-c2
_______________________________________________
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs

Reply via email to