[Bug-mit-scheme] Fwd: Re: Proposed fixes for the web pages of MIT-Scheme

[Thérèse Godefroy]

-------- Message transféré --------
Sujet : Re: [Bug-mit-scheme] Proposed fixes for the web pages of MIT-Scheme
Date : Wed, 4 May 2016 22:01:38 +0200
De : Therese Godefroy <address@hidden>
Pour : Matt Birkholz <address@hidden>

Hello Matt,

Sorry for giving you so much trouble.


Le 04/05/2016 19:33, Matt Birkholz a écrit :
[...]

> Who is Ineiev?

Ineiev (Pavel Kharitonov) is the gnu.org translation wizard: he manages
the translation teams, maintains GNUN (the build system for
translations), and coordinates Russian translations. He is also a webmaster.


[...]
> Our webpages were built by a Scheme pre-processor hacking the
> index.xml file template.  I've translated the new boilerplate into the
> necessary Scheme code for the pre-processor, but the pre-processor
> chokes on starting lines like these:
> 
>       <!--#include virtual="/server/header.html" -->
>       <!-- Parent-Version: 1.79 -->
> 
>> In addition, [1] and [3] have a large number of repetitive acronyms
>> or links which are bothersome for the reader.
> 
> Much of the pre-processing is about consistently using <acronym> (or
> <abbr> -- whatever).  I hesitate to tear that all out; I didn't write
> it.

The only article I have seen that had repetitive acronyms dates back to
1997:
https://www.gnu.org/philosophy/gif.html
The acronyms were removed quite a few years ago. I don't think anybody
would want them back.  ;)

In any case you can retrieve old code from the CVS.


>> Upgrading those pages to the latest boilerplate [4],
> 
> Unfortunately your boilerplate is not XHTML, something our validating
> pre-processor is dead set against generating.  Is there a "tag
> balanced" version we CAN generate?  Something like

I know this boilerplate isn't XHTML, and I wish it were; it would make
things simpler for translators.

The current mit-scheme pages have expanded SSIs for header.html and
banner.html, but intact ones for head-include-* and body-include-*. You
could do the same thing. I think it's pretty safe, because banner.html
shouldn't change unless someone completely redesigns the page -- but IMO
this person will have a hard time convincing Ineiev of implementing the
change.

banner.html is here:
http://web.cvs.savannah.gnu.org/viewvc/*checkout*/www/server/banner.html?root=www&content-type=text%2Fplain

[...]
>> replacing <acronym> with <abbr>,
> 
> Done.
> 
>> reducing their number and avoiding repetitions [5]
> 
> Working on that.
> 
>> I also added the "emph-box" class (light gray background) to the
>> code blocks in [2].
> 
> Done.
> 
> Patch attached.
> 
I noticed that you kept the lengthy comment about translations:

<!-- TRANSLATORS: Ignore the original text in this paragraph,
        [...]
        href="/server/standards/README.translations.html">Translations
        README</a>. -->

It doesn't apply here because the translation teams don't translate
software/*. The only useful boilerplate comment is that about copyright
years. In fact, the boilerplate instructions are not quite appropriate,
I think. But that's another issue.


Thanks for all your work,
Therese