Re: [Firebird-website] Wrong Firebird 2.1 Language Reference Update published

[Alexey K. <ak...@ib...>]

  Dmitry,

Please also send your version of docs building system to me.

I think we need to have virtual machine with pre-setup doc building system.
Now setup of whole doc system looks very long and complex.

  Regards,
Alexey Kovyazin




> Hi Paul,
>
>> It looks like you didn't commit any of your changes to CVS; is that correct?
> Correct. As we were field testing the new site on firebirdtest.com and many links are absolute, my copy contained all the links changed to the new structire but prefixed with firebirdtest.com. As you see, this is not something to be committed :-) Now we have to change the prefix to firebirdsql.org and it could be comitted then.
>
> I will send you my working copy (with the changed links) soon, so that you could validate the changes and move the work further. I won't be able to help in the next couple of weeks.
>
>> Also, did you only modify the sources and upload the generated content as-is, or did you have to post-process the HTML as well?
> I've modified only the sources and the generated files have been uploaded.
>
>> Another thing: most<ulink>s that point to within the Firebird site are either relative (in which case they can stay as they are) or absolute local links into the /manual or /pdfmanual trees. /manual and /pdfmanual (and a couple more) are symlinks to the real locations. They were created for two reasons:
>>
>> a) to save use some typing
>> b) to make them independent from the real paths
>>
>> I.e., by creating a handful of symlinks on the new site, these links don't have to be updated at all.
> All the absolute paths have been changed to fit the new site structure. All the relative paths were left "as is". If they don't include the root folders (manual/pdf/etc) they are OK. Otherwise they need a correction as well.
>
>> On the new site, in the web root directory, manual should point to file/documentation/reference_manuals/user_manuals/html, and pdfmanual to file/documentation/reference_manuals/user_manuals/
> The locations were changed the folowing way:
>
> firebirddocs ->  /documentation/reference_manuals/user_manuals
> refdocs ->  /documentation/reference_manuals/reference_material
> rlsnotes ->  /documentation/release_notes
> papers ->  /documentation/papers_presentations
>
> The PDFs are in the root location, HTMLs are in the /html subdirectory. The language specific versions are suffixed with the language ID and placed in the same location (similarly to the old site). All the file names are the same between old and new site versions.
>
>
> Dmitry
>
> ------------------------------------------------------------------------------
> Simplify data backup and recovery for your virtual environment with vRanger.
> Installation's a snap, and flexible recovery options mean your data is safe,
> secure and there when you need it. Discover what all the cheering's about.
> Get your free trial download today.
> http://p.sf.net/sfu/quest-dev2dev2
> _______________________________________________
> Firebird-website mailing list
> Fir...@li...
> https://lists.sourceforge.net/lists/listinfo/firebird-website
>