time/1/9/6/8/CondonReport/readme.htm

Summary

Maintainability
Test Coverage
<!--#include virtual="/header-start.html" -->
<title>Condon Report, LisezMoi! du NCAS</title>
<meta content="https://www.ncas.org/condon/text/readme.htm" name="url">
<meta content="Jim Giglio (coordinateur du NCAS, Projet Rapport Condon)" name="author">
<!--#include virtual="/header-end.html" -->
<section>
  <h2>Général</h2>
  <p>Préparer un document pour présentation sur le Web n'est pas la même chose que de rassembler un livre ou rapport
    imprimé. Une copie papier est linéaire ; le lecteur va typiquement d'une page à la suivante dans l'ordre des numéros
    de page. Mais un document web, faire défiler les éléments écran après écran (comme s'il s'agissait des pages d'un
    livre) devient très rapidement fatiguant. Les documents web sont donc généralement découpés en petits segments et
    <i>hyperliés</i> de sorte que le lecteur puisse cliquer d'un élément à un autre sans considération pour l'ordre des
    pages.</p>
  <p>Le Rapport Condon, même dans sa version papier d'origine, possédait certaines caractéristiques d'un document web.
    Etant un rapport pour le gouvernement, il commençait par présenter ses conclusions, suivi de données étayantes ;
    celles-ci peuvent être lues dans pratiquement n'importe quel ordre. En adaptant le rapport au web, nous avons tenté
    de tirer avantage de cette segmentation intrinsèque tout en préservant la plupart des éléments de son "look and
    feel" d'origine <span class="note">RR0 : le look & feel n'a pas été considéré intéressant à maintenir</span>.</p>
</section>
<section>
  <h2>Organisation et liens</h2>
  <p>
    Le point d'entrée de base du rapport est la <a href="contents.html">Table des Matières</a> (un lien cliquable depuis
    la <a href="index.html">Page de Titre</a>). Chaque entrée dans la <a href="contents.html">table des matières</a> est
    également un lien cliquable, vers :</p>
  <ul>
    <li>un chapitre dans une section,</li>
    <li>un en-tête de section avec des liens vers ses chapitres,</li>
    <li>une annexe,</li>
    <li>un index de liens vers les planches photographiques,</li>
    <li>un index de liens séparé vers les figures, ou</li>
    <li>l'index du document en entier.</li>
  </ul>
  <p>Chaque <a href="s4/index.html">étude de cas</a> (il y en a 59) est également atteignable via un ensemble de liens
    séparés depuis <a href="s4/index.html">les 3 chapitres contenant les cas</a>.</p>
  <p>À l'exception de quelques-uns des plus courts, tous les chapitres présentent un ensemble de liens internes vers
    leurs sous-chapitres numérotés <span
      class="note">RR0 : la numérotation a été jugée inutile dans un document web</span>. Ils vous permettent de
    naviguer dans les chapitres par petits morceaux ; chaque sous-chapitre possède également un lien "Retour" vous
    renvoyant en haut du chapitre <span class="note">RR0 : ces liens retours ont été supprimés car redondants avec la fonction
    "retour/précédent" des navigateurs web</span>, où un autre lien vous ramènent vers la <a href="contents.html">table
      des matières</a> <span class="note">RR0 : les liens vers la table des matières ou plus généralement les niveaux
    supérieurs onté été intégrés dans la barre de navigation en haut et bas de chaque page</span>. Lorsque vous voyez
    une "Introduction" numérotée 0, cela est dû au fait que l'auteur d'origine n'avait pas fourni d'introduction
    numérotée, et que nous en avons inséré une dans l'intérêt d'une navigation "pointe et clique".</p>
  <p>Les planches et figures individuelles ne possèdent pas de liens ; utilisez simplement la "flèche-retour" de votre
    navigateur pour revenir au lien qui vous a amené à la planche ou la figure.
  </p>
</section>
<section>
  <h2>"Look and feel"</h2>
  <p>Le document avec lequel nous avions commencé était le rapport d'origine tel que soumis à l'<a
    href="/org/us/dod/af/index.html">Air Force</a> <time>1968</time>, que nous avions obtenu du Système de la
    Bibliothèque de l'Université du Colorado. Il consistait simplement en 1400 pages dactylographiées entremêlées de
    plus de 100 figures et plus de tableaux que nous ne voulions en compter, plus quelque 65 pages de planches
    photographiques.</p>
  <p>Nous avons préservé l'organisation d'origine du rapport, même au point de maintenir sa pagination d'origine (sauts
    de page montrant les numéros de page dans des doubles crochets, comme ceci : [[666]]) <span class="note">RR0 : les
      sauts et numéros de page ont été supprimés pour le confort de lecture</span>. Nous n'en avons cependant pas été
    esclaves ; le texte apparaît dans la fonte que vous choisissez depuis le paramétrage des options de votre navigateur
    <span class="note">RR0: le texte apparaît dans la fonte de la charte graphique du site RR0</span>, et lorsque vous
    ajustez les bordures de la fenêtre du navigateur, le texte se re-découpera pour s'ajuster aux nouvelles marges. Nous
    avons également pris certaines libertés avec l'apparence d'origine des tableaux, les tableaux préparés sur une
    machine à écrire tendant à être laids et difficiles à lire.
  </p>
  <p>De temps en temps dans le texte, vous verrez des notes éditoriales expliquant des déviations significatives par
    rapport à l'apparence et/ou l'organisation d'origine du texte ou des graphiques. Des exemples incluent :</p>
  <ul>
    <li>Echanger les axes horizontaux et verticaux d'un tableau ou d'un graphique,</li>
    <li>Corriger la numérotation des sous-chapitres,</li>
    <li>Corriger les références de texte aux figures ou aux tableaux, ou</li>
    <li>Noter des anomalies, telles que l'absence de notes en bas de page correspondant aux numéros entre parenthèses
      dans le texte.</li>
  </ul>
  <p>Les blocs colorés sur la <a href="index.html">page de titre</a> sont les seuls que vous verrez <span
    class="note">RR0 : Ils ont été supprimés dans cette version</span> ; le rapport d'origine ne contient
    essentiellement pas d'éléments décoratifs quels qu'ils soient, et nous ne voyons pas de raison de dévier de cette
    politique ; le rapport tient ou tombe sur son contenu informatif et sa méthodologie scientifique, pas sur son thème
    de couleurs.</p>
</section>
<section>
  <h2>Graphiques et expressions mathématiques</h2>
  <p>À mesure que vous défilerez dans les chapitres, vous rencontrerez des graphiques "incrustés" ; pour gagner du temps
    dans le chargement de chapitres contenant de lourds graphiques dans votre navigateur, nous avons rendus ces
    graphiques sous la forme de petites images "vignettes" sur lesquelles on peut cliquer pour présenter l'image en
    pleine taille <span class="note">RR0 : les vignettes ont été remplacées par les images pleine taille d'origine pour
    faciliter la lecture. Le volume de chargement ne pose plus de problème aujourd'hui]</span>.</p>
  <p>Les expressions mathématiques, dans la plupart des cas, ont été rendus du texte ordinaire, en utilisant la capacité
    des "tableaux" <a href="/tech/info/soft/data/doc/html">HTML</a> pour contrôler leur disposition avec une certaine
    précision. Là où des caractères grecs apparaissent, nous les avons généralement rendus phonétiquement ("alpha",
    "beta", etc.). Un chapitre (<a href="s6/c04/index.html"><em>Mirage optique</em></a>, en <a href="s6/index.html">section
      6</a>) était lourdement chargé d'expressions mathématiques, incluant de nombreux caractères grecs et autres
    symboles spéciaux. Dans ce chapitre, les expressions mathématiques sont rendus sous forme d'images graphiques
    séparées incluses dans le texte. Il y a plus de 75 de ces images, et donc le chapitre <a
      href="s6/c04/index.html"><em>Mirage optique</em></a> pourrait nécessiter un temps substantiel à se charger.</p>
</section>
<section>
  <h2>Naviguer depuis l'index</h2>
  <p>Bien qu'il puisse sembler bizarre d'inclure l'index en adaptant un document au format papier au web, le fait que
    nous l'ayons inclus, avec les numéros de pages d'origine, vous offre un autre moyen de naviguer dans le rapport.
    Faites simplement défiler les entrées jusqu'à ce que vous repériez quelque chose d'un intérêt possible, puis notez
    le numéro de page et utilisez la <a href="contents.html">Table des Matières</a> pour localiser le chaptire
    approprié. Une fois dans le chapitre, utilisez la fonctionnalité "rechercher" du navigateur pour aller directement à
    cette page. Par exemple, si le numéro de page est 445, la chaîne de recherche serait "[[445]]" <span class="note">RR0: Ceci a été remplacé par un moteur de recherche en page de titre]</span>.
  </p>
  <p>À l'évidence, ceci marche mieux si votre système permet à 2 fenêtres de navigateur d'être actives au même moment.
    Cela fonctionnerait même si chaque numéro de page dans l'index était cliquable. Nous travaillerons là-dessus pour la
    prochaine version.</p>
</section>
<section>
  <h2>Conclusion : quel navigateur?</h2>
  <p>Le codage <a href="/tech/info/soft/data/doc/html">HTML</a> a été testé avec <a
    href="/org/us/company/ms/MSIE.html">Microsoft Explorer</a> comme <a
    href="/org/us/company/netscape/Navigator.html">Netscape Navigator</a>, principalement sous <a
    href="/org/us/company/ms/product/soft/windows">Windows</a> 3.1 sur un <a
    href="/tech/info/hard/computer/PC.html">PC</a> basé sur un 486. Avec quelques exceptions telles que le <a
    href="s6/c04/index.html">chapitre sur le mirage optique</a>, tout se charge avec une rapidité raisonnable dans cet
    environnement. Le navigateur que vous utilisez, et le fait que vous ayez un Pentium avec une connexion Internet
    décente ne devraient donc pas faire grande différence, et le chargement et la performance de défilement devraient
    être plus qu'adéquates.
  </p>
  <p>Si votre navigateur vous permet de désactiver les images ou les tableaux, et que vous l'avez fait, la plupart des
    informations du rapport vous sera inaccessible ; vous devriez réactiver ces fonctionnalités en consultant ce
    document. Il n'y a qu'un élément (l'index) qui utilise plusieurs cadres, et si votre navigateur ne sait pas afficher
    les cadres, une version de l'index sans cadres (légèrement moins pratique à naviguer) sera affichée automatiquement.
    Nous n'avons utilisé ni <a href="/org/us/company/oracle/sun/ptf/java">Java</a> ni <a
      href="/tech/info/soft/proj/design/arch/web/js">Javascript</a>, ni des graphiques animés d'aucune sorte ; comme
    indiqué ci-dessus, le contenu informatif est ce qui compte, pas les "paillettes" de la présentation.
  </p></section>
<!--#include virtual="/footer.html" -->