Aneamal-Version 2018-S07

Die Aneamal-Version 2018-S07 steht zum Herunterladen bereit.

Neu in dieser Version: Du kannst einfach Videos und Audiodateien einbinden. Außerdem gibt es neben Kopfbereich (header) und Fußbereich (footer) jetzt einen dritten Bereich (aside), der automatisch mit Nebenbemerkungen wie einer Kurzvorstellung des Autors oder weiterführenden Links gefüllt und zum Beispiel als Seitenleiste dargestellt werden kann.

Weitere Änderungen betreffen Details bei der Übersetzung von Aneamal zu HTML. Auf dieser Seite stelle ich ausgewählte Neuerungen vor. Eine kurz gefasste Liste aller Änderungen findet sich in der Versionsgeschichte.

Übrigens, wenn du von der vorigen auf die neue Version aktualisieren möchtest, genügt es, diese drei Dateien zu ersetzen:

Es ist aber gegebenenfalls empfehlenswert, außerdem die htaccess-Datei zu aktualisieren. Informationen dazu findest du am Ende dieser Seite.

Videos oder Audiodateien einbinden

Mit [v]-> lassen sie Video- und Audiodateien einbinden. Die Syntax ist in beiden Fällen identisch. Zwei einfache Beispiele:

[v]->omas-80ter-geburtstag.mp4

[v]->mein-lieblingslied.mp3

Welche Dateiformate abspielbar sind, hängt vom Webbrowser des Lesers und nicht vom Aneamal-Konverter ab. Mozilla hat eine Übersicht unterstützter Formate angelegt – ohne Gewähr auf Aktualität, Vollständigkeit oder Richtigkeit.

Vor dem Link zur Mediendatei kann ein Vorschaubild angegeben werden. Bei Videos wird es angezeigt, bevor die Wiedergabe gestartet wird. Empfehlenswert ist, die Bildabmessungen passend zu jenen des Videos zu wählen. Bei Audiodateien wird das Bild dauerhaft, also vor und während der Wiedergabe angezeigt:

[v]->fotos/selfie-mit-oma.jpg->omas-80ter-geburtstag.mp4

Man kann als dritte Datei am Ende auch noch eine Untertiteldatei im WebVTT-Format angeben, um für Gehörlose und Fälle, in denen Ton abzuspielen technisch nicht möglich oder nicht angemessen ist, Audiobeschreibungen als Text einblenden zu lassen.

[v]->kate-bush.jpg->wuthering-heights.mp3->lyrics.vtt

Beachte:

Wie bei anderen Dateieinbindungen kann man Video- und Audiodateien eine Beschriftung beifügen:

[v]->VID0012.webm
Bello, neeiiiiiin …!

Wie beim Einbinden von Bildern kann man mit {…} auch bei Videos und Audiodateien Anmerkungen ergänzen, die typischerweise angezeigt werden, wenn man mit dem Mauszeiger über der Wiedergabefläche weilt:

[v]->VID0012.webm{Willst du das Schlachtfeld wirklich sehen …?}
Bello, neeiiiiiin …!

Zu guter Letzt kann man per [v:…]-> wie bei Bildern auch eine Kurzbeschreibung des Medieninhaltes angeben. Diese Beschreibung ist anders als bei Bildern aber derzeit für Browser nicht zugänglich, da HTML dafür noch keine Möglichkeit bereitstellt.

[v:Ein gelber Hund stürzt sich auf eine Geburtstagstorte.]->VID0012.webm
Bello, neeiiiiiin …!

Wenn man möchte, dass eine einmal gestartete Mediendatei in einer Schleife kontinuierlich abgespielt wird, bis man sie manuell stoppt oder die Seite verlässt, bindet man sie mit [w]-> statt [v]-> ein. Alle oben beschriebenen Funktionen funktionieren bei [w]-> genauso wie bei [v]->.

Aside (Nebenbemerkungen)

Zusätzlich zu den Dateien @header.nml, @footer.nml und @look.css wird nun auch die Datei @aside.nml automatisch eingebunden, wenn sie im gleichen oder einem übergeordneten Verzeichnis einer abgefragten Aneamaldatei liegt.

Die Datei @aside.nml kann für Inhalte benutzt werden, wie sie typischerweise in Seitenspalten ergänzt werden – Links zu verwandten Seiten beispielsweise, kurze Informationen über den Betreiber des Internetauftritts oder eine Kolumne. In der HTML-Ausgabe werden sie zwischen dem Hauptteil der Seite und dem Fußbereich eingebunden – können aber per Style-Angaben anders positioniert werden.

Wie es analog auch für die anderen automatisch ladbaren Dateien der Fall ist, kann man das automatische Laden in einer Aneamaldatei ausschließen:

@aside: off

Alternativ ist es möglich, manuell eine andere „Aside“-Datei anzugeben:

@aside: ->ausmalsweise-dies-hier.nml

Übersetzung nach HTML

Kopf- und Fußbereich, Seitenstruktur

Insgesamt stellt sich das Gerüst der HTML-Ausgabe damit wiefolgt dar, falls die entsprechenden Bestandteile vorhanden sind:

<!doctype html>
<html>
  …
  <body>
    <header>…</header>
    <main>…</main>
    <aside>…</aside>
    <footer>…</footer>
  </body>
</html>

Zitatblöcke

Die Quellenangabe eines Zitatblocks wird nun mit dem HTML-Element <cite> (statt <footer>) markiert. Hier ein Beispielzitat in Aneamal:

> Die großen Leute verstehen nie etwas von selbst.
Antoine de Saint-Exupéry: Der kleine Prinz

Und hier die HTML-Entsprechung:

<blockquote>
  <p>Die großen Leute verstehen nie etwas von selbst.</p>
  <cite>Antoine de Saint-Exupéry: Der kleine Prinz</cite>
</blockquote>

Überschriften mit Zusätzen

Wenn man Überschriften eine Zusatzzeile nachstellt, werden beide in HTML mit <div role='group'> (statt <header>) gruppiert. Hier eine Beispielüberschrift in Aneamal, der eine Tagline hinzugefügt wurde:

=== Alien ===
In space, no one can hear you scream.

Und hier die HTML-Entsprechung:

<div role='group'>
  <h1>Alien</h1>
  <p>In space, no one can hear you scream.</p>
</div>

Video- und Audiodateien

Die neue Funktion zum Einbinden von Videos und Audiodateien nutzt für beide Fälle das HTML-Element <video>. Das ist Absicht, auch wenn es ein HTML-Element <audio> gibt. In HTML sind <audio> und <video> zwei Seiten derselben Medaille, die man als Medien-Element bezeichnen könnte. Der Unterschied zwischen beiden ist oberflächlich, nämlich dass das <video>-Element einen Darstellungsbereich nutzt, das <audio>-Element hingegen nicht. Den Darstellungsbereich des <video>-Elementes nutzt Aneamal auch bei Audiodateien, wenn als Standbild zum Beispiel ein Schallplatten-Cover angegeben wird oder wenn eine Audiobeschreibung zum Beispiel für Gehörlose hinterlegt wird. Das <video>-Element wird in ein <figure>-Element eingebettet.

So in etwa wird das obige Beispiel mit Audiobeschreibung in HTML umgesetzt:

<figure>
  <video src='wuthering-heights.mp3' poster='kate-bush.jpg' controls>
    <track src='lyrics.vtt' kind='captions'>
    <a href='wuthering-heights.mp3'>wuthering-heights.mp3</a>
  </video>
</figure>

So in etwa wird das obige Beispiel mit Anmerkung in HTML umgesetzt:

<figure>
  <video src='VID0012.webm' title='Willst du das Schlachtfeld wirklich sehen …?' controls>
    <a href='VID0012.webm'>VID0012.webm</a>
  </video>
  <figcaption>Bello, neeiiiiiin …!</figcaption>
</figure>

.htaccess aktualisieren

Mit dieser Version des Aneamal-Konverters wurde eine Zeile der htaccess-Datei geändert. Die Änderung ermöglicht, umfangreichere Vorlagen beim Laden von Aneamaldateien zu nutzen. Wenn du zum Update die neue Datei htaccess.txt hochlädst, musst du die alte Datei .htaccess vom Server löschen und die neue Datei dort in .htaccess umbenennen. Fertig.

Falls du deiner htaccess-Datei eigene Regeln hinzugefügt hast, mag es dir lieber sein, deine alte Datei zu bearbeiten statt sie zu ersetzen. Für diesen Fall findest du hier Erläuterungen:

Wenn deine htaccess-Datei auf dem Stand der Version 2017-K08 ist, findest du in ihr diese Zeile:

RewriteRule ^aneamal(-config|/a-|/cache|/main) - [L,F]

Wenn deine htaccess-Datei auf einem neueren Stand ist, findest du in ihr diese Zeile:

RewriteRule ^aneamal(-config|/a-|/cache|/main) - [F,END]

Ersetze jene Zeile durch:

RewriteRule ^aneamal(-config|/cache|/main) - [F,END]

Falls deine htaccess-Datei auf einem älteren Stand ist, findest du keine der beiden genannten Zeilen. Entweder ist deine htaccess-Datei dann auf dem Stand einer der beiden Versionen 2017-B25 beziehungsweise 2017-H02 und du brauchst nichts zu ändern – oder sie ist noch älter und damit so veraltet, dass du sie besser komplett aktualisierst, weil auch andere Aneamal-Techniken mit ihr nicht funktionieren können, zum Beispiel das Einbinden von Bildern per [j]->.

Danksagung

Danke an David für die fruchtbaren Gespräche zur Weiterentwicklung von Aneamal.