Verzeichnis mit Code-Dateien einfügen
Mit dieser Funktion werden alle Dateien eines lokalen Verzeichnissens in die aktuelle Datei eingebettet. Es erfolgt keine weitere Bearbeitung durch
Definition
$$$ dir zuordnung : lokaler Dateipfad $$$
- Zuordnung
-
Eindeutiger Bezeichner der Funktion
- lokaler Dateipfad
-
Ein relativer (ab Projektverzeichnis) oder absoluter Pfad zum Verzeichnis, das eingefügt werden soll.
Verarbeitung
- Die Funktion sollte alleinstehend in einer Zeile positioniert sein.
- Das Einlesen erfolgt in alphabetischer Reihenfolge der Dateien im Verzeichnis.
- Jede Datei wird mit
<div>…</div>umschlossen. - Es findet keine Prüfung statt, ob die vorgefundenen Dateien dafür geeignet sind und das Ergebnis eine darstellbare Datei erzeugt.
- Sinnvoll verwendbar ist dieser Befehl nur für Verzeichnisse, in denen HTML-Fragmente oder PHP-Skripte (soweit auf dem Server unterstützt) vorliegen.
Wird ein Projekt vollständig neu erzeugt, muss gewährleistet werden, dass die hinzugeladenen Dateien bereits verfügbar sind.
Ein leeres Verzeichnis erzeugt keine Fehlermeldung.
Eine Anwendung kann ein Glossar aus vorhandenen HTML-Elementen sein. Für die Online-Hilfe wird das Glossar allerdings mit »mddir« erzeugt.