MIDI_SPICKZETTEL_asciiDOC |
|||||
version: V00.24…2019-12-24 |
|||||
ERSTAUSGABE |
|||||
erstellt von: |
|
|
|
|
(lies: |
|||||
MAX_der_mit_dem_klex_) |
ins Web gestellt von: |
FABLAB REGION NÜRNBERG |
|
|
MIDI_SPICKZETTEL_asciiDOC
-
soll Dir|Ihnen helfen, beim Erstellen von Dokumenten:
-
gehe zum INHALTSVERZEICHNIS
-
EinfachKlick.li auf das gewünschte Thema
-
Thema ablesen oder BeispielCode kopieren
-
nächstes Thema.
-
-
Sofort erkennbar:
-
Unsere AuskunftDrehscheibe ist das INHALTSVERZEICHNIS.
-
Ein "SUCHEN"-Feld existiert nicht!
-
MIDI_SPICKZETTEL_asciiDOC ist:
-
ein Arbeits-Hilfsmittel
-
ein NachschlageWerk
-
ein HowTo
-
ein SpickZettel
-
ein "WAS_mache_ich_WIE?"
MIDI_SPICKZETTEL_asciiDOC ist KEIN Lehrgang!
MIDI_SPICKZETTEL_asciiDOC nennt für die Erstellung von Dokumenten:
Syntax-Regeln + Fussangeln.
Ergänzend wird kurz auf Vorgehen & Strategie-Aspekte eingegangen.
|
Note
|
BEHANDELT WERDEN: • Erstellung in asciiDOC-Format mittels TextEditor… • …eines sequentiell zu lesenden Dokumentes • Speicherung und PapierDruck dieses Dokumentes in QuellTextFormat • Anzeige im Browser dieses Dokumentes in ZielForm • Speicherung mittels Browser dieses Dokumentes in ZielForm als PDF-Datei • PapierDruck dieses Dokumentes in ZielForm. |
|
Important
|
(NOCH) NICHT BEHANDELT WERDEN: • (Noch) Unfertiges • Dokument als WebSeite • Dokument als Bildschirm-Dialog • nicht vom Browser unterstützte Darstellung einer asciiDOC-Dokument-Datei |
|
Important
|
BEACHTE: • Der Verfasser war zum Thema asciiDOC blutiger Anfänger. • Die Erstellung von MIDI_SPICKZETTEL_asciiDOC diente seiner Einarbeitung quasi ohne Hilfe Dritter. • Die meisten Kapitel haben ihre manchmal skurrile erste Erprobungs&Test-Form beibehalten, da funktionsfähig. • Kapitel unter ÜBERSCHRIFTEN IN SCHRÄGSCHRIFT (ITALIC) wurden nachoptimiert… • … und sind als "VergleichsBeispiel für QuellText in ZielForm" zu empfehlen! |
GLIEDERUNG
MIDISPICKZETTELasciiDOC:
. 1. EIN_DOKUMENT_MITTELS_TEXT-EDITOR_ERSTELLEN: 2. BEISPIELE: 3. SCHRITT_FÜR_SCHRITT_KURZANLEITUNG: _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ ANHANG_A: ZUR_BEGRÜSSUNG: ANHANG_B: asciiDOC_&_asciiDOCTOR: ANHANG_C: MIDI_SPICKZETTELasciiDOC___ERSTAUSGABE: ANHANG_D: NAVIGATION_TESTS: ANHANG_E: ÜBERSCHRIFTEN_GLIEDERUNG: ANHANG_F: NACHWORT: _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ ANHANG_Z: ARBEITSNOTIZEN+LOP: ANHANG_Y: THEMEN_SAMMLUNG FÜR MAXI_SPICKZETTEL:
1. EIN_DOKUMENT_MITTELS_TEXT-EDITOR_ERSTELLEN:
1.1. GENERELLES:
|
Important
|
BEACHTE: typische "FUSSANGELN" in asciiDOC: • vor jedem ÜBERGANG zu neuem Informations-Typ: • • LEERZEILE! • • dh LEERZEILE beendet den bisherigen Informations-Typ! • AUSNAHME: Header-Block: • • beginnt ohne LeerZeile!! • • aber endet mit erster LeerZeile!! • fehlender | falscher TABELLENabschluss: • • bringt GESAMMTES DOKUMENT DURCHEINANDER!!! • • korrekt ist als letzte Zeile der TabellenDefinition: |=== • vielfach hintereinander wiederholte Satzzeichen: • • werden reduziert auf ein Satzzeichen-Exemplar! • • zur Wiederholung ist auf UTF8-Code auszuweichen! |
BEISPIEL für ÜBERGANG zu neuen Informations-Typen:
-
ÜBERSCHRIFT > TABELLE > TEXTBLOCK > AUFZÄHLUNG
BEACHTE AUSSERDEM:
| EINGABE mittels Editor: | BEWIRKT im ZielDokument: |
|---|---|
nächste Zeile im Textfluss |
Leerzeichen |
Leerzeile im Textfluss |
nächste Zeile |
Leerzeichen = erstes Zeichen eines Textblockes |
Darstellung als Originaler_TextBlock |
1.2. HEADER:
|
Important
|
BEACHTE:
• beginnend in oberster Zeile! • in einem Block zu schreiben … • • ohne Leerzeile! • • ohne Einrückung! • Aufbau der Zeilen: • • :THEMA:Text • Zeilen-Reihenfolge = beliebig! • Header wird beendet mittels Leerzeile! |
1.3. TEXTE+FORMATE:
1.3.1. DOKUMENT-TITEL & ÜBERSCHRIFTEN:
|
Important
|
Überschriften:
• stehen zwischen LeerZeilen! • beginnen ohne Einrückung! • müssen OHNE ZeilenUmbruch geschieben werden. Die Nummerierung aller betroffenen Überschriften: • erfolgt automatisch: • • wie & sofern unter :TOC: definiert! |
ÜBERSCHRIFTEN werden streng hierarchisch gegliedert gemäss:
(Das ÜBERSCHRIFTEN-Beispiel musste ausgegliedert werden ans Ende von MIDI_SPICKZETTEL_asciiDOC,
da es die Überschriften-Nummerierung des MIDI_SPICKZETTEL-Kernbereiches verfälscht hätte.)
1.3.2. STANDARD_TEXTBLOCK:
Sehr simpel: Wie geschrieben , so (fast) angezeigt!
|
Important
|
TextBlöcke:
• stehen zwischen LeerZeilen! • beginnen ohne Einrückung! • am ZeilenAnfang keinesfalls Zeichen ident zu Asciidoc-Befehlen: • • statt dessen UTF8-"Umschreibung"! • ZeilenUmbruch innerhalb des TextBlocks = ohne Auswirkung! • im QuellCode 2 ZeilenUmbrüche (= 1 Leerzeile): ergibt NeuZeile! • im QuellCode 3 ZeilenUmbrüche (= 2 Leerzeilen): ergibt nächsten Absatz (TextBlock)! |
EINGABE:
4 TextBlöcke mit doppelten LeerZeilen:
"In der Realität sind die Abgrenzungen verwischt und auch Kombinationen unterschiedlicher Strukturen |Generationen innerhalb eines Systemes üblich. Dennoch: Ordnung muss sein, um darüber sprechen zu können!"
"… (fange niemals ein Schriftstück mit "ich " an, hatte uns die Deutschlehrerin eingebleut
doch jetzt bin ich erwachsen, soo erwachsen, dass andre mich alt nennen, … was meine Freiheiten mächtig erweitert bezüglich:…"
"Paragraphs don’t require any special markup in AsciiDoc.
A paragraph is just one or more lines of consecutive text.Paragraphs don’t require any special markup in AsciiDoc.
A paragraph is just one or more lines of consecutive text."
To begin a new paragraph, separate it by at least one blank line.
Newlines within a paragraph are not displayed.
To begin a new paragraph, separate it by at least one blank line.
Newlines within a paragraph are not displayed.
ERGEBNIS:
"In der Realität sind die Abgrenzungen verwischt und auch Kombinationen unterschiedlicher Strukturen |Generationen innerhalb eines Systemes üblich. Dennoch: Ordnung muss sein, um darüber sprechen zu können!"
"… (fange niemals ein Schriftstück mit "ich " an, hatte uns die Deutschlehrerin eingebleut doch jetzt bin ich erwachsen, soo erwachsen, dass andre mich alt nennen, … was meine Freiheiten mächtig erweitert bezüglich:…"
"Paragraphs don’t require any special markup in AsciiDoc. A paragraph is just one or more lines of consecutive text.Paragraphs don’t require any special markup in AsciiDoc. A paragraph is just one or more lines of consecutive text."
To begin a new paragraph, separate it by at least one blank line. Newlines within a paragraph are not displayed. To begin a new paragraph, separate it by at least one blank line. Newlines within a paragraph are not displayed.
1.3.3. ORIGINALER_TEXTBLOCK:
Originaler_TextBlock bleibt erhalten wie eingegeben.
|
Important
|
originaler_TextBlock:
• ist nahezu identisch zu STANDARD_TEXTBLOCK! • beginnt jedoch mit Einrückung! • STEUERZEICHEN etc werden unwirksam … • … aber bleiben erhalten & sichtbar! • ein nachfolgender TextBlock (2 Leerzeilen!) ist ohne eigene Einrückung wieder STANDARD_TEXTBLOCK! |
EINGABE
TextBlöcke 1+3 sind originaler_TextBlock:
"In der Realität sind die Abgrenzungen verwischt und auch Kombinationen unterschiedlicher Strukturen |Generationen innerhalb eines Systemes üblich. Dennoch: Ordnung muss sein, um darüber sprechen zu können!"
"… (fange niemals ein Schriftstück mit "ich " an, hatte uns die Deutschlehrerin eingebleut
doch jetzt bin ich erwachsen, soo erwachsen, dass andre mich alt nennen, … was meine Freiheiten mächtig erweitert bezüglich:…"
"*Paragraphs* don’t require any special markup in AsciiDoc.
A paragraph is just one or more lines of consecutive text.Paragraphs don’t require any special markup in AsciiDoc.
A paragraph is just one or more lines of consecutive text."
*To begin* a new paragraph, separate it by at least one blank line. Newlines within a paragraph are not displayed. To begin a new paragraph, separate it by at least one blank line. Newlines within a paragraph are not displayed.
ERGEBNIS:
"In der Realität sind die Abgrenzungen verwischt und auch Kombinationen unterschiedlicher Strukturen |Generationen innerhalb eines Systemes üblich. Dennoch: Ordnung muss sein, um darüber sprechen zu können!"
"… (fange niemals ein Schriftstück mit "ich " an, hatte uns die Deutschlehrerin eingebleut doch jetzt bin ich erwachsen, soo erwachsen, dass andre mich alt nennen, … was meine Freiheiten mächtig erweitert bezüglich:…"
"*Paragraphs* don't require any special markup in AsciiDoc. A paragraph is just one or more lines of consecutive text.Paragraphs don't require any special markup in AsciiDoc. A paragraph is just one or more lines of consecutive text."
To begin a new paragraph, separate it by at least one blank line. Newlines within a paragraph are not displayed. To begin a new paragraph, separate it by at least one blank line. Newlines within a paragraph are not displayed.
1.3.4. ASCIIDOCs_SCHRIFTFORMATE_IM_TEXTFLUSS: • unvollständig!
SchriftFormate lassen sich im TextFluss feingranular an jeder ZeichenPosition verändern:
Verwendet werden die Zeichen: ` * _
| WAS: | EINGABE-BEISPIEL: | ERGEBNIS: |
|---|---|---|
MONOSPACE: |
` mach mich konstant! `, but me not! |
|
FETT: |
* mach mich fett! *, but me not! |
mach mich fett!, but me not! |
ITALIC: |
_ mach mich schräg! _, but me not! |
mach mich schräg!, but me not! |
|
Important
|
!!!!!!!!MIR FEHLEN DRINGEND!!!!!!!!!!!!!:
SchriftFormate|SteuerZeichen für: • Schrift_stark_VERGRÖSSERN • Schrift_stark_VERKLEINERN • Schrift_VERSTECKEN • Schrift_ERSETZEN • • (… Ersetzen ersetzt Verstecken!?) • NEUE Seite |
FORMATE_KOMBINIEREN:
-
Beim FORMATE_KOMBINIEREN ist asciiDOC ausgesprochen sensibel:
|
Important
|
BEACHTE: • Reihenfolge der FormatSymbole (aussen > innen > aussen) exakt gem Tabelle einhalten! • was nicht benötigt, "paarweise" weglassen! • PositionsVersatz = erlaubt unter Beibehaltung der Reihenfolge! |
| WAS: | EINGABE: | ERGEBNIS: |
|---|---|---|
KOMBINATION:
|
davor ` * _ innen mit M+F+I _ * ` danach |
davor |
VERSETZTE_KOMBINATION: |
davor `MONO * M+FETT _ M+F+ITALIC innen _ * ` danach |
davor |
1.3.5. HTML_STEUERZEICHEN_IM_TEXTFLUSS: • unvollständig!
HTML-Steuerzeichen lassen sich im TextFluss feingranular an jeder ZeichenPosition einfügen:
| WAS: | EINGABE: | ERGEBNIS: |
|---|---|---|
UNTERSTREICHEN: |
+ + + <u>underline me</u> + + + , but me not! |
underline me, but me not! |
DURCHSTREICHEN: |
+ + + <s>streich mich durch</s> + + + , aber mich nicht! |
|
VERKLEINERN um eine Stufe: |
Sometimes [small]#smaller text# is nice, |
Sometimes smaller text is nice, |
VERGRÖSSERN um eine Stufe: |
sometimes [big]#larger# is better |
sometimes larger is better |
BEISPIEL FÜR FARBGEBUNG & KOMBINATION:
EINGABE:
[red]#red text# [yellow-background]#on yellow# [big]#large# [red yellow-background big]*all bold*
STEUERZEICHEN_KOMBINIEREN:
-
Beim STEUERZEICHEN_KOMBINIEREN ist asciiDOC sensibel:
|
Important
|
BEACHTE:
• was nicht benötigt, "paarweise" weglassen! • PositionsVersatz = erlaubt unter Beibehaltung der Reihenfolge! |
| WAS: | EINGABE: | ERGEBNIS: |
|---|---|---|
KOMBINATION:
|
+ + + <u><s>kombiniere mich </s></u> + + + , aber mich nicht! |
|
VERSETZTE_KOMBINATION: |
+ + + <u><s>kombiniere </s>mich </u> + + + , aber mich nicht! |
|
1.3.6. ASCIIDOCs_SCHRIFTFORMATE_UND_HTML_STEUERZEICHEN_KOMBINIEREN:
-
SchriftFormate & SteuerZeichen lassen sich im TextFluss kombinieren.
|
Important
|
Die Kombination SchriftFormate & SteuerZeichen
• = jedoch besonders sensibel… • … und wird aus Zeitmangel zurückgestellt. • sofern unverzichtbar: SELBST_TESTEN! |
1.3.7. UTF8_IM_TEXTFLUSS
• BUCHSTABE • ZIFFER • SYMBOL • EMOJ:
asciiDOC & asciiDOCTOR haben die wunderbare Eigenschaft, die darstellbaren UTF8-Zeichen zu unterstützen, dh. asciiDOC & asciiDOCTOR steht die gesammte internationale Welt offen.
Die Arbeitsschritte für Einfügen von UTF8-Zeichen sehen wie folgt aus:
-
ich hole mir ein Zeichen aus Zeichentabellen+Schriftsystemen zB:
-
kopiere dies "feingranular positioniert" in mein Dokument:
-
dasZeichen …
-
… oder - falls das Probleme macht - :
-
den UTF8-DezimalCode = &#__;
-
den UTF8-HexaDezimalCode = &#x___;
-
-
-
kontrolliere, was der Browser anzeigt.
|
Important
|
BEACHTE: • UTF8 enthält die ASCII-Zeichen als Untermenge (mit identischer CodeNummer). • asciiDOCTOR unterstützt NICHT JEDES UTF8-STEUERZEICHEN… … aber anscheinend alle UTF8 -: • -BUCHSTABEn • -ZIFFERn • -SYMBOLe • -EMOJs |
1.3.8. wichtige SATZZEICHEN:
| WAS: | DIREKT-EINGABE: | oder: UTF8-CODE: |
ERGEBNIS: | ANMERKUNG: |
|---|---|---|---|---|
Leerzeichen: |
>>>→> LEERZEICHEN: |
|||
Punkt |
. |
. |
. |
|
Komma |
, |
, |
, |
|
Strichpunkt |
; |
; |
; |
|
Doppelpunkt |
: |
: |
: |
|
Ausrufezeichen |
! |
! |
! |
|
Fragezeichen |
? |
? |
? |
|
Bindestrich |
- |
- |
- |
kürzer als Gedankenstrich |
Gedankenstrich |
. |
&#????????????????????????; |
. |
länger als Bindestrich |
Unterstrich |
_ |
_ |
_ |
|
Doppelstrich |
= |
= |
= |
|
Anführung.unten |
„ |
„ |
„ |
|
Anführung.oben |
" |
"; |
" |
|
Apostroph |
' |
’ |
' |
|
Klammer.rund.auf |
( |
( |
( |
|
Klammer.rund.zu |
) |
) |
) |
|
Klammer.eckig.auf |
[ |
[ |
[ |
|
Klammer.eckig.zu |
] |
] |
] |
|
Klammer.schweif.auf |
{ |
{ |
{ |
|
Klammer.schweif.zu |
} |
} |
} |
|
Schrägstrich |
/ |
/ |
/ |
|
kaufmannsUND |
& |
& |
& |
1.3.9. wichtige MARKIER-ZEICHEN: • in Arbeit!
WAS: |
DIREKT-EINGABE: |
oder: |
ERGEBNIS: |
ANMERKUNG: |
Stern * * Raute # # Paragraph § § Spiegelstrich ?????????????? ????????????????????? Doppelstrich = &#61; = Kreis.voll ?????????????? ????????????????????? Kreis.mager ?????????????? ????????????????????? Kreis.voll ?????????????? ????????????????????? Kreis.mager ?????????????? ????????????????????? Pfeil.voll ?????????????? ????????????????????? Pfeil.mager ?????????????? ????????????????????? Pfeil.offen > >
1.3.10. KAUFMANN-ZEICHEN: • unvollständig!
Euro € € Dollar $ &#36; $ Pfund kaufmannsUND & &#38; & Prozent % &#37; % Promille ?????????????? ????????????????????? Istgleich = &#61; =
1.3.11. MATHEMATIK:
>>>_>> https://unicode-table.com/de/blocks/mathematical-operators/ ( = UTF8/2200—22FF)
1.3.13. RÖM-ZIFFERN: • unfertig!
Die heutzutage verwendeten römischen Ziffern:
U+2160 Ⅰ ROMAN NUMERAL ONE
U+2164 Ⅴ ROMAN NUMERAL FIVE
U+2169 Ⅹ ROMAN NUMERAL TEN
U+216C L ROMAN NUMERAL FIFTY
U+216D C ROMAN NUMERAL ONE HUNDRED
U+216E D ROMAN NUMERAL FIVE HUNDRED
U+216F M ROMAN NUMERAL ONE THOUSAND
Zeichen: I V X L C D M
= Wert: 1 5 10 50 100 500 1000
1.3.15. GERÄTE & MASCHINEN: • unvollständig!
ↀ
= Römische Zahl eintausend C D
= Roman Numeral One Thousand C D
= Unicode-Nummer: U+2180
= HTML-Code: ↀ
1.3.16. ELEKTROTECHNIK: • in Arbeit!
Sinus Wechselstrom U+223F
Kopieren und einfügen ∿ Technical information Name Sine Wave Unicode-Nummer U+223F HTML-Code ∿ CSS-code \223F Block Mathematische Operatoren Unicode-Version: 1.1.5 (1993) Eintragung des Zeichens in verschiedenen Schriftarten ∿Ihrem Browser ∿Arial ∿Times New Roman Charakterbeschreibung Sinus. Mathematische Operatoren. Codierung Codierung hex dec (bytes) dec binary UTF-8 E2 88 BF 226 136 191 14846143 11100010 10001000 10111111 UTF-16BE 22 3F 34 63 8767 00100010 00111111 UTF-16LE 3F 22 63 34 16162 00111111 00100010 UTF-32BE 00 00 22 3F 0 0 34 63 8767 00000000 00000000 00100010 00111111 UTF-32LE 3F 22 00 00 63 34 0 0 1059192832 00111111 00100010 00000000 00000000
1.3.17. EMOJS: • in Arbeit!
zwischen Emoticons und Smileys ist zu unterscheiden!!
Details & sortiert nach Bedeutung:
BEISPIELE:
| WAS: | ZEICHEN-EINGABE: | oder: UTF8-EINGABE: |
ERGEBNIS: | ANMERKUNG: |
|---|---|---|---|---|
Lira (Währung) |
₤ |
₤ |
₤ |
|
schwarzes Lächeln |
☻ |
☻ |
☻ |
Eine wunderbare Eigenschaft: mit Vergrösserung spielen:
| WAS: | ZEICHEN-EINGABE: | oder: UTF8-EINGABE: |
ERGEBNIS: | ANMERKUNG: |
|---|---|---|---|---|
schwarzes Lächeln |
☻ |
☻ |
☻ |
|
schwarzes Lächeln.vergrössert |
[big]#☻# |
☻ |
☻ |
nur 1 (geringe) Vergrösserungsstufe möglich! |
Herz [♥] |
icon:heart[5x] |
????????????????? |
[heart] |
5-fach vergrössert! |
1.4. DATENCONTAINER:
Daten in hoher Anzahl lassen sich auf unterschiedlichste Weise anordnen|anzeigen.
|
Important
|
BEACHTE: Nachfolgende UnterKapitel folgen dem Schema: • <ÜBERSCHRIFT:> = optional • • dann: EINGABE: Beispiel • • • die Titel-Zeile kann weggelassen werden! • • sodann: ERGEBNIS: der Eingabe. |
1.4.1. LISTE:
1.4.2. AUFZÄHLUNG:
EINGABE:
.OPTIONALER_TITEL:
. element
. . ebene.tiefer
. . ebene.tiefer
. . ebene.tiefer
. . . ebene.tiefer.tiefer
. . . ebene.tiefer.tiefer
. . . ebene.tiefer.tiefer
. . . . ebene.tiefer.tiefer.tiefer
. . . . ebene.tiefer.tiefer.tiefer
. . . . . ebene.tiefer.tiefer.tiefer.tiefer
. . . . . ebene.tiefer.tiefer.tiefer.tiefer
. . . . . ebene.tiefer.tiefer.tiefer.tiefer
. . . . ebene.tiefer.tiefer.tiefer
. element.nächstes
. . ebene.tiefer
. . . ebene.tiefer.tiefer
. . . . ebene.tiefer.tiefer.tiefer
. element.nächstes
ERGEBNIS:
-
element
-
ebene.tiefer
-
ebene.tiefer
-
ebene.tiefer
-
ebene.tiefer.tiefer
-
ebene.tiefer.tiefer
-
ebene.tiefer.tiefer
-
ebene.tiefer.tiefer.tiefer
-
ebene.tiefer.tiefer.tiefer
-
ebene.tiefer.tiefer.tiefer.tiefer
-
ebene.tiefer.tiefer.tiefer.tiefer
-
ebene.tiefer.tiefer.tiefer.tiefer
-
-
ebene.tiefer.tiefer.tiefer
-
-
-
-
element.nächstes
-
ebene.tiefer
-
ebene.tiefer.tiefer
-
ebene.tiefer.tiefer.tiefer
-
-
-
-
element.nächstes
1.4.3. LABEL_LISTE_STANDARD:
1.4.4. LABEL_LISTE_HORIZONTAL:
1.4.6. TABELLEN:
asciiDOC unterstützt Tabellen mannigfaltig.
Ich habe vieles ausprobiert:
-
die meisten Tabellen-QuellCode-Vorlagen sind …
-
Ramsch!!:
-
… unlogisch
-
… unübersichtlich
-
… arbeitsaufwendig!
-
-
Ich habe zwei Ausführungen optimiert. Sie sind als QuellCode-KopieVorlage nachfolgend erläutert:
|
Important
|
für Tabellen gilt generell: • die Anzahl an "|" muss korrekt sein, … • • … sonst fehlen Spalten | Zeilen | Felder | Daten! • bei leeren Feldern folgen zwei || direkt ohne Zwischeneintrag … • • die GesamtAnzahl der | ist wie bei "voller" Tabelle! |
SIMPEL-TABELLE:
STANDARD-TABELLE: •
|
Important
|
BEACHTE: • was zusätzlich benötigt wird: • • ergänzen! • was nicht benötigt wird: • • weglassen! |
|
Important
|
Der . vor tabelleNAME erzeugt die fortlaufende TabellenNummer … • … kann weggelassen werden! Die Leerzeile nach spalteNAME erzeugt die spalteNAME-Fettschrift … • … daher: NICHT WEGLASSEN! weitere Leerzeilen dienen der Übersichtlichkeit … • … könnten weggelassen werden … was nicht so gut ist! |
EINGABE:
.<tabelleNAME> |=== ||<spalteNAME_1> |<spalteNAME_2> |<spalteNAME_3 |<spalteNAME_4>
|*<zeileNAME_1>* |<INHALTspalte_1+zeile_1> |<INHALTspalte_2+zeile_1> |<INHALTspalte_3+zeile_1> |<INHALTspalte_4+zeile_1>
|*<zeileNAME_2>* |<INHALTspalte_1+zeile_2> | |<INHALTspalte_3+zeile_2> |<INHALTspalte_4+zeile_2> |===
1.5. DOKUMENTGESTALTUNG:
|
Important
|
asciiDOC erzeugt Dokumente KEINE Plakate, Zeitschriften, Zeitungen, Wurfzettel, Briefe, …! |
asciiDOCs Dokumenten-Erzeugung ist überzeugend!
-
Das Dokumenten-Konzept entspricht dem eBook:
-
Inhalt seriell fortlaufend
-
einspaltig….ausser bei Tabellen etc.
-
asciiDOC ist trotz Einschränkungen mit einer ÜberFülle an Ergänzungen & Optimierungen ausstattet.
-
Nachfolgend eine Auswahl-Übersicht zur DOKUMENTGESTALTUNG:
1.5.1. GESTALTUNGS-ELEMENTE-ÜBERSICHT:
| WAS: | EINGABE: | ANMERKUNG: | ERGEBNIS: |
|---|---|---|---|
LEERZEICHEN: |
>>>→> LEERZEICHEN: |
>>>→> LEERZEICHEN: |
|
ÜBERSCHRIFTEN: |
|||
NEUE_ZEILE & LEERZEILEN: |
zeileX + + + <br/><br/><br/> + + + zeileX+4 |
zeileX |
|
HORIZONTAL_LINIEN: |
` ` ` |
[quote] wie in tabelle anzeigen???????? |
|
LEERER_SEITENBEREICH |
verwende & >>>_>> ORIGINALER_TEXTBLOCK: |
||
SYMBOL |
>>>_> SYMBOL_MIT_TEXTFELD: |
>>>_> SYMBOL_MIT_TEXTFELD: |
|
SYMBOL |
|||
BILD |
|||
VIDEO |
|||
AUDIO |
1.5.2. LEERZEICHEN:
-
LEERZEICHEN:
| WAS: | EINGABE: | ANMERKUNG: | ERGEBNIS: |
|---|---|---|---|
LEERZEICHEN.fiktiv |
iii​iii |
UmbruchPosition |
iiiiii |
LEERZEICHEN.extrem_schmal |
iii iii |
iii iii |
|
LEERZEICHEN.sehr_schmal |
iii iii |
iii iii |
|
LEERZEICHEN.schmal |
iii iii |
iii iii |
|
LEERZEICHEN.schmal |
iiiߙiii |
iii iii |
|
LEERZEICHEN.schmal+umbruchgeschützt |
iii iii |
iii iii |
|
LEERZEICHEN.schmal+umbruchgeschützt |
iii iii |
iii iii |
|
LEERZEICHEN.normal |
iii iii |
iii iii |
|
LEERZEICHEN.breit |
iii iii |
iii iii |
|
LEERZEICHEN.breit |
iiiॷiii |
!!!!!!!!!!!noch NICHT ok !!!!!!!!!!!!!!!!! |
iiiॷiii |
Weitere Deteils zu LEERZEICHEN: https://de.wikipedia.org/wiki/Leerzeichen
1.5.3. SYMBOL_MIT_TEXTFELD:
asciiDOC stellt fertige Kombinationen-Symbol+Textfeld zur Verfügung:
1.5.4. SYMBOL_MIT_STRUKTURIERTEM_TEXTFELD:
Das Textfeld lässt sich erweitern:
-
mehrzeilig
-
als Liste
-
auch mit Mehrfach-Einrückung!
-
1.6. LINK + NAVIGATION + INTERAKTION:
Das HauptTHEMA lautet:
-
Wie muss ich mein Dokument für sinnvolle LINKs + NAVIGATION + INTERAKTION ausstatten & gestalten?
Nachrangiges NebenTHEMA:
-
Darstellung der PapierVersion? • in Arbeit!
1.6.1. mouseOVER:
mouseOVER ist extrem praktisch, wenn auf begrenztem Raum viel zu nennen ist (zB Aufzählung techn Ausstattung):
-
Abkürzung = immer sichtbar
-
LANGTEXT erscheint nur bei Überfahren mit der Maus!
-
SchriftFormate funktionieren NICHT!
1.6.2. INHALTS-VERZEICHNIS >> INHALT
Vom INHALTS-VERZEICHNIS zum INHALT:
-
Setzen im Header: >>>→> TOC:
-
bewirkt automatisches INHALTS-VERZEICHNIS …
-
… zuzüglich automatisch: Verweis und Anker für jede genannte Überschrift.
-
BEISPIEL: vorliegender MIDI SPICKZETTEL asciiDOC.
-
|
Important
|
BEACHTE:
• :toclevels: setzen: • bestimmt den DetailGrad des INHALTS-VERZEICHNISses |
1.6.3. INHALT >> INHALT _ _ _ _ ANKER SETZEN:
|
Important
|
BEACHTE:
• Anker eines Dokumentes haben unterschiedliche Namen! • Anker sind in der Dokument-ZielForm unsichtbar. • Anker sind auch im laufenden Text positionierbar. • good use: Anker 2 Zeilen vor Überschrift setzen. |
1.6.4. INHALT >> INHALT _ _ _ _ LINK SETZEN:
|
Important
|
BEACHTE:
• Links sind Verweise auf einen Anker. • Es können mehrere Links auf einen Anker weisen. • Links sind im laufenden Text positionierbar. • Links sind in der Dokument-ZielForm sichtbar mit blauem Farbumschlag. • Fehlt der blaue Farbumschlag, so ist der QuellCode fehlerhaft! • Links werden mit linker|rechter MausTaste ausgelöst. |
EINGABE:
Ich bin Text mit <<TESTANKER_1>> ZielAngabe …
(… und zwar liegt die ZielAngabe "TESTANKER_1" im Text integriert direkt vor dem Wort "ZielAngabe" …
… und bleibt im ErgebnisDokument sichtbar).
BEISPIEL_2 = Ziel_2: <<ZIEL_2>> …
… das im FussBereich des Documentes im ANHANG_???????? liegt.
ERGEBNIS:
Ich bin Text mit [TESTANKER_1] ZielAngabe …
(… und zwar liegt die ZielAngabe "TESTANKER_1" im Text integriert direkt vor dem Wort "ZielAngabe" …
… und bleibt im ErgebnisDokument sichtbar).
BEISPIEL_2 = Ziel_2: [ZIEL_2] …
… liegt im FussBereich des Documentes.
1.6.5. FUSS-NOTE:
Bisher konnte ich kein Kommando "NÄCHSTE SEITE!" ausfindig machen. FUSS-NOTE ist daher zurückgestellt.
1.6.6. KAPITEL_NOTE:
Vorläufig ausführen mittels:
-
INHALT >> INHALT_LINK SETZEN: an aktueller Position: INHALT >> INHALT _ _ _ _ LINK SETZEN:
-
INHALT >> INHALT_ANKER SETZEN: am KapitelEnde & vor dem Text der KAPITEL_NOTE: INHALT >> INHALT _ _ _ _ ANKER SETZEN:
1.6.7. END_NOTE:
Vorläufig ausführen mittels:
-
INHALT >> INHALT_LINK SETZEN: an aktueller Position: INHALT >> INHALT _ _ _ _ LINK SETZEN:
-
INHALT >> INHALT_ANKER SETZEN: am DokumentEnde & vor dem Text der END_NOTE: INHALT >> INHALT _ _ _ _ ANKER SETZEN:
1.6.8. BILD EINFÜGEN: GENERELLES:
TYPISCHES VORGEHEN:
-
alle Bilder an einer Stelle nahe an der Quellcode-DokumentDatei speichern
-
im Header des Dokumentes unter :imagesdir: diese Stelle als relativen Pfad angeben
-
(bezogen auf den SpeicherOrt der Quellcode-DokumentDatei)
-
-
Bild am Platz des Dokumentes nennen.
Beispiel: :imagesdir: ../asciiDOC_MIDIspick/BILDER/
|
Important
|
BEACHTE:
• CHROMIUM.asciiDOCTOR interpretiert ":imagesdir:" fehlerhaft: • • DateiAngabe: 1 Stufe oberhalb beginnen!! WIR UNTERSCHEIDEN: • Bild als SELBSTÄNDIGE BLOCKEINHEIT • Bild als EINFÜGUNG |
1.6.9. BILD ALS SELBSTÄNDIGE BLOCKEINHEIT:
Bild am ZeilenAnfang nennen gemäss Schema:
image::<BILDDATEI-NAME>.<BILDDATEI_EXTENSION>[<ERSATZTEXT>,<BREITE>,<HÖHE>]
|
Important
|
BEACHTE:
• DOPPELTER DOPPELPUNKT! • Schema gilt mit ":imagesdir:"-Angabe • ohne ":imagesdir:"-Angabe Schema erweitern: • • <PFAD><BILDDATEI-NAME>. … • das BildFormat " .???" wird nicht unterstützt! |
1.6.10. BILD EINFÜGUNG:
Bilder lassen sich feingranular an jeder ZeichenPosition einfügen in:
-
Fliesstext an beliebiger Position
-
Datencontainern
-
zB Tabelle
-
gemäss dem Schema:
image:<BILDDATEI-NAME>.<BILDDATEI_EXTENSION>[<ERSATZTEXT>,<BREITE>,<HÖHE>]
|
Important
|
BEACHTE:
• EINFACHER DOPPELPUNKT! • Schema gilt mit ":imagesdir:"-Angabe • ohne ":imagesdir:"-Angabe Schema erweitern: • • <PFAD><BILDDATEI-NAME>. … • bei Tabellen wird die BildGrösse automatisch angepasst … • • … an die Grösse des TabellenFeldes • • … bleiben somit "<BREITE>,<HÖHE>" unberücksichtigt! • das BildFormat " .???" wird nicht unterstützt! |
1.6.11. LINK AUF RECHNER & homeNET: • in Arbeit!
2. BEISPIELE:
2.1. EINFACHE_BEISPIELE: • in Arbeit!
2.1.1. KOPIEVORLAGE BEISPIEL_1:
-
kopieren ab Ende: EINGABE:
-
bis vor: ERGEBNIS:
-
-
einfügen in den Anhang des eigenen Dokuments
-
nacheditieren
EINGABE:
====== ERSTELLUNG DIESES DOKUMENTS: . Vorliegendes Dokument wurde erstellt mittels der leichtgewichtigen, hochleistenden Arbeitskette: . * *asciiDOC* ** das *Editierverfahren* für die Dokument-Rohausführung *** kurze Beschreibung.de: https://de.wikipedia.org/wiki/AsciiDoc *** ausführliches Nachschlagewerk.de: ????????????????????????????? *** offizielle Einführung.en: "AsciiDoc Writer’s Guide" https://asciidoctor.org/docs/asciidoc-writers-guide/ * *asciiDOCTOR* ** der in üblichen Browsern verfügbare *Compiler* zur Generierung des Dokuments in Endform. *** Anleitung.de: asciiDOCTOR im Browser aktivieren: ?????????????????????????????#asciiDOCTOR_AKTIVIEREN: *** Anleitung.de: Chrome-Plugins-installieren: https://www.heise.de/tipps-tricks/Google-Chrome-Plugins-installieren-deinstallieren-und-anzeigen-4221689.html
ERSTELLUNG DIESES DOKUMENTS:
Vorliegendes Dokument wurde erstellt mittels der leichtgewichtigen, hochleistenden Arbeitskette:
-
asciiDOC
-
des Editierverfahrens für die Dokument-Rohausführung
-
kurze Beschreibung.de: https://de.wikipedia.org/wiki/AsciiDoc
-
ausführliches Nachschlagewerk.de: ?????????????????????????????
-
offizielle Einführung.en: "AsciiDoc Writer’s Guide" https://asciidoctor.org/docs/asciidoc-writers-guide/
-
-
-
asciiDOCTOR
-
dem in üblichen Browsern verfügbaren Compiler zur Generierung des Dokuments in Endform.
-
Anleitung asciiDOCTOR im Browser aktivieren.de: ?????????????????????????????#asciiDOCTOR_AKTIVIEREN:
-
Anleitung.de: Chrome-Plugins-installieren: https://www.heise.de/tipps-tricks/Google-Chrome-Plugins-installieren-deinstallieren-und-anzeigen-4221689.html
-
-
2.4. MIDI_SPICKZETTEL_asciiDOC
• als GENERALBEISPIEL
• als FUNDGRUBE:
Alles — wirklich alles — was im SPICKZETTEL als Thema abgehandelt:
-
ist im SPICKZETTEL selbst bereits angewendet …
-
… und getestet …
-
… und als SpickZettel-Quellcode direkt einsehbar!
-
-
zusätzlich waren im SPICKZETTEL weitere spezielle Trix erforderlich …
-
… ebenso einsehbahr! … ====== QUELLCODE_EINSEHEN +
QUELLCODE_ALS_VORLAGE:
-
|
Warning
|
Beschrieben wird nachstehend der einfachste Fall:
• mit dem Chrome-Browser … • … als AsciiDoc-QuellCode_Betrachter. |
|
Warning
|
Beachte das Kapitel:
• SCHRITT_FÜR_SCHRITT_STARTANLEITUNG: … • • … >>>_> DOKUMENT_ANZEIGEN: |
ABLAUF:
-
>>>_>> bereits erstellte QuellDatei im Format <DOKUMENTNAME>.asciidoc …
-
>>>_>> … als Anzeige
-
Browser startet automatisch mit der SPICKZETTEL-ErgebnisDarstellung
-
>>>_>> KommandoLeiste …
-
>>>_>> Asciidoctor.js Preview …
-
… das startet automatisch die QuellCode-Darstellung!
|
Note
|
BEACHTE:
diese QuellCode-Darstellung ist:
• lesbar • kopierbar • NICHT editierbar! |
3. SCHRITT_FÜR_SCHRITT_KURZANLEITUNG:
3.1. PRINZIP:
-
Unter Benutzung von asciiDOC-Midi-SPICKER …
-
… wird mittels TextEditor das asciiDOC-QuellCode-Dokument erstellt …
-
… und arbeitsbegleitend im Browser das entsehende EndDokument "beobachtet".
-
Abschliessend Speicherung & PapierDruck von QuellCode und EndDokument.
|
Warning
|
UNBEDINGT ERFORDERLICH:
• Web-Zugang • Browser in aktueller Version: • • Chrome • • Chromium • • Firefox • • andere Browser sind ungeeignet! |
|
Note
|
BEACHTE:
• Beim beschriebenen Verfahren halten wir die Daten auf dem eigenen Rechner! • ES GEHEN KEINERLEI DATEN INS INTERNET! |
3.3. EIGENE SITUATION HINTERFRAGEN:
Bevor wir einsteigen, sollten wir hinterfragen:
-
Will ich mein bisheriges Dokument-Erstellungs-Verfahren - zumindest testweise - hinter mir lassen?
-
Wenns nicht klappt, sind dann meine mit asciiDOC erstellten EditierErgebnisse Schrott?
-
… NEIN, sie sind über COPY&PASTE aufwandarm ins bisherige System überführbar …
-
… und ich um eine Erfahrung bereichert.
-
-
Wie geeignet sind: asciiDOC + asciiDOCTOR?:
-
Antwort könnte geben: >>>→>
-
-
Wie zuverlässig wird der SPICKZETTEL mich unterstützen?:
-
geeignet? vollständig? fehlerhaft? erprobt?
-
Zu diesen Fragen geben Auskünfte: >>>→>
-
3.4. AUSSTATTUNG KLÄREN:
Vorhanden:
-
PC?
-
TextEditor?
-
Web-Zugang?
-
Browser in aktueller Version?…
-
Chrome | Chromium | Firefox
-
-
-
asciiDOC-Midi-SPICK in Ausführung?…
-
PDF-Datei auf dem Bildschirm | PDF-PapierDruck
-
3.5. asciiDOCTOR_AKTIVIEREN:
-
Browser starten
-
Die Extension für Asciidoc im Browser aktivieren,
nachfolgend erklärt am Beispiel: CHROMIUM:-
starte CHROMIUM
-
>>>_>> Einstellungen (= Costomize and control Chromium)
-
>>>_>> More Tools
-
>>>_>> Extensions
-
>>>_>> Asciidoctor.js Live Preview
-
>>>_>> Schalterstellung:EIN
-
in der HeaderZeile des Browsers erscheint das ASCIIdoc-Symbol:
-
Anklicken des Symbols schaltet die ASCIIdoc-Funktion ein & aus!
-
-
-
die ArbeitsSchritte gelten sinngemäss für CHROME & Firefox
3.6. UNTERSTÜZUNG DURCH asciiDOC-Midi-SPICK:
Typischerweise kann asciiDOC-Midi-SPICK in 4 Varianten genutzt werden:
-
asciiDOC-Midi-SPICK in Endform als PapierDruck: >>>→> "SPICKEN" VOM PAPIER:
-
asciiDOC-Midi-SPICK in Endform als PDF-Datei
-
asciiDOC-Midi-SPICK in Endform als Web-Seite: >>>→> [muss Ian angeben!!!!!!!!!!!!!!!!!]
-
asciiDOC-Midi-SPICK als Quell-Datei. Details: >>>→> "SPICKEN" IM BROWSER:
3.7. "SPICKEN" VOM PAPIER:
-
>>> "Inhaltsverzeichnis" …
-
… >>>_>> <gewünschtes Thema> …
-
… Kapitel-Nummer merken:
-
unter diesem Kapitel findet sich das Ergebnis!
3.8. "SPICKEN" IM BROWSER:
-
>>>_>> bereits gespeicherte QuellDatei asciiDOC-Midi-SPICK.asciidoc …
-
DoppelKlick.li
-
-
>>>_>> … als Anzeige
-
DoppelKlick.li
-
Browser startet automatisch mit dem asciiDOC-Midi-SPICK-EndDokument.
-
-
>>> "Inhaltsverzeichnis" …
-
… >>>_>> <gewünschtes Thema>:
-
Browser springt zum Ergebnis!
-
-
>>>→> BrowserPfeil "ZURÜCK"
-
EinfachKlick.li
-
Browser springt zum >>> "Inhaltsverzeichnis"
-
-
nächstes Thema
3.9. DOKUMENT_ERSTELLEN:
-
Gem. Kapitel:
>>>_> EIN_DOKUMENT_MITTELS_TEXT-EDITOR_ERSTELLEN: mit beliebigem TextEditor:-
QuellDatei-Code eingeben!
-
-
Abspeichern als QuellDatei im Format: <DOKUMENTNAME>.asciidoc
Hinweise auch in:
MIDI_SPICKZETTEL_asciiDOC
• als GENERALBEISPIEL
• als FUNDGRUBE:
3.10. DOKUMENT_ANZEIGEN:
Wir wählen den einfachste Fall mit dem Browser als AsciiDoc-Compiler.
|
Warning
|
VORBEDINGUNG:
• Web-Zugang • Browser in aktueller Version: • • Chrome • • Chromium • • Firefox • • andere Browser sind ungeeignet! |
-
>>>_>> bereits gespeicherte QuellDatei <DOKUMENTNAME>.asciidoc …
-
DoppelKlick.li
-
>>>_>> … als Anzeige
-
DoppelKlick.li
-
Browser startet automatisch mit der <DOKUMENTNAME>.Ergebnis-Darstellung.
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
-
AB HIER: ERGÄNZENDE INFORMATIONEN & HILFSDATEN
ANHANG_A:
ZUR_BEGRÜSSUNG:
Hej! Hallo! Grüetzi! Grüss_Gott! Servus! Guten_Tag! …
Der Verfasser war immer schon auf der Suche nach einem arbeitsparendem Dokument-Editor, …
|
Caution
|
… der sein sollte:
• universell • übersichtlich • fehlerarm • portabel über sein persönliches Equipment (LINUX, RASPi; ANDROID, …) • optisch ansprechend in seinem Dokument-Endergebnis • nicht überladen • leicht erlernbar|begreifbar • kompakt im TransferFormat • … |
asciiDOC & asciiDOCTOR decken das inzwischen ab …
und das so gut, dass man nach den ersten TestSeiten vom Produkt nicht mehr lassen kann.
Doch eine sinnvolle Anleitung in Deutsch war nicht zu finden, …
… daher habe ich meine eigene kleine Sammlung aufgebohrt zum:
• MIDI__SPICKZETTEL__asciiDOC
• ERSTAUSGABE
• erstellt auf asciiDOC & asciiDOCTOR.
Ich hoffe, er - der SPICKZETTEL - ist hilfreich!
ANHANG_B:
asciiDOC_&_asciiDOCTOR:
Wer Details wissen will:
-
de.kurze Beschreibung: "AsciiDoc":
https://de.wikipedia.org/wiki/AsciiDoc -
de.kurze Übersicht: "AsciiDoc-Features für Pragmatisches": https://jaxenter.de/asciidoc-features-66027
-
de.kurze Beispiele: "So sieht Asciidoc aus":
https://docplayer.org/4357093-Gesunde-dokumentation-mit-asciidoctor.html -
en.offizielle KurzAnleitung: "Asciidoctor Documentation":
https://asciidoctor.org/docs/ -
en.offizielle Einführung: "AsciiDoc Writer’s Guide"
https://asciidoctor.org/docs/asciidoc-writers-guide/ -
en.offizielles User Manual: "Asciidoctor User Manual"
https://asciidoctor.org/docs/user-manual/ -
en.https://asciidoctor.org/docs/user-manual/#what-is-asciidoctor
Vielleicht genügen nachfolgende Kurz-Charakterisierungen?:
.1. asciiDOC:
asciiDOC ist die Definition einer vereinfachten Auszeichnungssprache zur schellen + fehlerarmen Erstellung von Dokumenten:
-
maschinenlesbar
-
vom Menschen ebenso direkt lesbar
-
als Norm fürs Web vorgesehen
-
Format-Konvertierungen zwischen Dokumentations-Systemen universell unterstützend.
|
Note
|
asciiDOC:
• ist auf den Inhalt eines Dokumentes ausgerichtet • die Gestaltung eines Dokumentes ist eher zweitrangig. |
Andere beschreiben das so:
AsciiDoc ist ein Textdokumentformat zum Schreiben von Notizen, Dokumentationen, Artikeln, Büchern, E-Books, Diashows, Webseiten, Manpages und Blogs. AsciiDoc-Dateien können über die Asciidoctor-Toolchain in viele Formate übersetzt werden, einschließlich HTML, PDF, EPUB, DocBook und Manpage. Es kann ein beliebiger Texteditor verwendet werden. Einige Websites wie Github rendern AsciiDoc-Dateien direkt in HTML.
.2. asciiDOCTOR:
asciiDOCTOR ist AsciiDoc’s Compiler für die Dokument-Ausgabe.
|
Note
|
asciiDOCTOR: kann aus einer asciiDOC-Datei ohne Veränderung erzeugen:
• die übersichtliche Druckvorlage • eine dazu identische grafische Rechner-Oberfläche mit interaktiver Bedienung: • • beides zwecks drastischer Arbeitsersparnis mittels Automatismen. |
|
Warning
|
asciiDOCTOR:
• existiert abhängig von der zugrunde liegenden Programmiersprache in diversen Ausprägungen: • identischer Inhalt der EndDokumente! • zueinander in Details abweichendes Dokument-Aussehen dieser Dokumente! |
.3. asciiDOC & asciiDOCTOR:
asciiDOC & asciiDOCTOR sind ein geniales ToolSystem zum Verfassen umfangreicher, universeller Dokumente:
-
verständliche, schlichte TastaturEingabe
-
robuste Übernahme bereits vorhandener DokumentTeile
-
lesbare, verständliche, speicherplatzschonende QuellDatei
-
übersichtlich
-
aufwandreduzierende Automatismen
-
aus dem Stand erlernbar.
asciiDOC & asciiDOCTOR haben die wunderbare Eigenschaft, die darstellbaren UTF8-Zeichen zu unterstützen. Dh. asciiDOC & asciiDOCTOR steht die gesammte internationale Welt offen…
… und das ohne irgendeine Verrenkung.
Die simple Eingabe mittels ASCII-Zeichensatz lässt selbst das Handy eintreten in die Welt von asciiDOC & asciiDOCTOR
-
AlphabethZeichen der Sprachen der Welt
-
Symbole
-
Emojs… das Handy kennt das ja schon lange.
ANHANG_C:
MIDI_SPICKZETTELasciiDOC___ERSTAUSGABE:
Die MIDI__SPICKZETTEL__asciiDOC …
… ERSTAUSGABE ist eine knapp gehaltene Auswahl an asciiDOC-Regeln:
-
ohne die sich ein sinnvolles Dokument nicht erstellen liesse!
-
… ist nicht mehr!
-
… ist aber auch nicht weniger!
Eine nächste AUSGABE = MINI-AUSWAHL für Einarbeitung ist bereits im Entstehen.
.1. SPICKZETTEL-STATUS-ÜBERSICHT:
| VERSION: | ARBEITS_TITEL: | ERFÜLLT: | ERFÜLLT_NICHT: | ANMERKUNG: |
|---|---|---|---|---|
V00.24—2019-12-24 |
asciiDOC_MIDIspick = AUSFÜHRUNG: WEB+BROWSER |
• LESEversion |
• ANWENDERtests |
an Ian: BITTE STELLS INS WEB!!!!!!! |
V00.17—2019-12-08 |
asciiDOC_MIDIspick = BROWSERAUSFÜHRUNG |
• LESEversion |
• WEBintegration |
ES WIRD ZEIT INS WEB ZU GEHEN!!! |
V00.15—2019-11-22 |
asciiDOC_MIDIspick |
• LESEversion |
• DOKUMENTnavigat. |
|
V00.11—2019-11-13 |
MIDI-ERSTAUSGABE |
• LESEversion |
• DOKUMENTnavigat. |
.2. SYMBOLIK_DES_SPICKZETTELS:
Eigentlich für ganz anderes geschaffen, werd ich mal meine SYMBOLIK-Sammlung erweitern & hier im SPICKZETTEL anwenden:
|
Note
|
Unter SYMBOLIK fasse ich ALLES zusammen:
• Begriffe • Abkürzungen, … • • … von mir Kürzel genannt • Symbole • CodeKürzel • Steuerzeichen • … |
Seit Jahren hat sich diese SYMBOLIK-Sammlung für mich bewährt!
STATUS+HANDLING:
SYMBOL: |
BEDEUTUNG: |
EINGABE: |
ANMERKUNG: |
_!!! |
BEACHTE! |
_!!! |
_!!!_! FÜHRE_AUS! _!!!_!
_??? |
UNKLAR! WIESO? |
_??? |
_???_? KLÄRE_AB! _???_?
_*** |
WICHTIG! |
_*** |
_***_* WICHTIG_VOR_ANDEREM!!! _***_*
_***_3 WICHTIG_MIT PRIO = 3 _***_3
• 9 = WICHTIGSTES
von ALLEN!!!!
• 0 = unwichtig
_⌗⌗⌗ überflüssig = _⌗⌗⌗
• ENTSORGEN!
• PAPIERKORB!
• LÖSCHEN!
_⌁⌁⌁ |
DRÄNGEND! |
_⌁⌁⌁ |
_⌁⌁⌁_⌁ DRINGEND_VOR_ANDEREM!!! _⌁⌁⌁_⌁
_⌁⌁⌁_5 DRINGEND_MIT PRIO = 5 _⌁⌁⌁_5
• 9 = DRINGENDSTES
von ALLEN!!!!
• 0 = hat Zeit!
_⌁⌁⌁_⌗ NIE!! _⌁⌁⌁_⌗ = Spanien: "MANIANA!"
! "Aus Zeitmangel" wurde noch nicht aufgenommen: ok!
gut!
schlecht!
fehlerhaft!
freigegeben!
verteilt!
gefährlich!
sichtbar!
ANHANG_D:
NAVIGATION_TESTS:
ANHANG_E:
ÜBERSCHRIFTEN_GLIEDERUNG:
.1. EINGABE:
= Document Title = Level 0
== Section = Level 1
=== Section = Level 2
==== Section = Level 3
===== Section = Level 4
====== Section = Level 5
= Section = Level 0
Document Title = Level 0
Section = Level 0
ANHANG_F:
NACHWORT:
Der Verfasser hatte die Arbeit zu diesem Spickzettel unterschätzt,
denn oberflächlich sollte das Ergebnis ja nicht sein (sowas gibts bereits im Web!)…
…und so wuchs sich insbesonders das Suchen und Testen von Funktionalitäten aus im asciiDOC-Grenzbereich (ASCII, UFT8, HTML, …).
Da es benötigt wird, geht MIDI_SPICKZETTEL_asciiDOC noch unfertig vorab ins Web. Fertigstellung ist zugesichert.
Wie geht es weiter?
-
Midi-SPICK bleibt im Themen-Umfang weiterhin unverändert. Die Einzel-Kapitel jedoch werden vervollständigt und optimiert.
-
mini-SPICK wird zusammengestellt mittels Auszug aus Midi-SPICK als autonome Workshop-KurzEinführung in asciiDOC.
-
MAXI-SPICK nimmt all das auf, was über Midi-SPICK thematisch hinausgeht (Komplexes, Kombination mit ProgrammCode, …). Midi + MAXI werden über Links eng miteiander verzahnt sein.
Und nun viel Spass & Erfolg mit Midi-SPICK-asciiDOC!
Herzlich,
M✹X _der_mit_dem_klex_
-
ENDE DER ERGÄNZENDEN INFORMATIONEN & HILFSDATEN
-
ENDE DES SPICKZETTEL-INHALTES
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
-
AB HIER: ARBEITSDATEN DES VERFASSERS
ANHANG_Z:
ARBEITSNOTIZEN+LOP:
|
Warning
|
NACHBESSERN: • •• |
|
Warning
|
LOP: • ANKER.allg: •• wie ANKER-ZielAngabe UNSICHTBAR??? • ANKER.Inhaltsverzeichnis: •• wie ANKER-ZielAngabe "[[⯅]]" VOR/AM BEGINN des Inhaltsverzeichnisses setzen??? • internVERWEIS: •• wie AUTOMATISIERT im Editor internVERWEIS vor jede Überschrift setzen??? ••• SUCHMUSTER = ok:^== ••• SETZMUSTER = NOTok: "<<⯅>> ==" •••• "… ..." macht Probleme!!!!! <br/> <br/> • internANKER+VERWEIS: <br/> •• ist "<<⯅>>" in obigem Beispiel schlechter geeignet als "<<㚎>>"????????????? • mouseOVER: <br/> •• für Text, NICHT BILD!!! <br/> <br/> • seitenUMBRUCH <br/> •• für Drucker, NICHT BILDSCHIRM!!! <br/> <br/> • ZURÜCK!_1 <br/> •• wie mit minimalem Aufwand??? <br/> ••• wäre der autoAnker an Überschriften als Trigger eines ZURÜCKskripts nutzbar??? <br/> <br/> • ZURÜCK!_2 (ALTERNATIVE) <br/> •• Steuerzeichen: GEHE ZU DOKUMENT-ANFANG! ??? <br/>+ |
FEHLEND|UNKLAR|LOP|nichtGETESTET|OPTIMUMoffen|_:
✓ UTF8_Einbettung
❏ HTML_Einbettung
❏ Text verstecken (= auskommentieren | ZusatzINFO für Entwurf | etc)
❏ Vergrössern | verkleinern:
EINZELzeichen
zeichenFOLGE
MEHRZEILENbereich
✓ sprungADRESSE innerhalb Dokument
❏ sprungADRESSE|verweis an EXTERN
❏ nichtPROPORTIONAL-schrift:
MEHRZEILENbereich
GESAMMTdokument
✓ mousOVER
✓ AUSWAHL einfacher TABELLENtypen
✓ Bild einfügen in TEXT
✓ Bild einfügen in TABELLE
❏ wieso in Überschrift Zeilenumbruch nach: |…: ,aber nicht bei NormalText?
✓ ZeilenUmbruch
✓ LeerZeile(n)
✓ LeerZeichen
✓ TOC
❏ HEADER.dokumentDEF
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
ANHANG_Y:
THEMEN_SAMMLUNG FÜR MAXI_SPICKZETTEL:
FEHLEND:
❏ AUSWAHL komplexer TABELLENtypen
L U O -kombiFELDer
❏ BILD im Lauftext
-
KOMPLEX-TABELLE:
ll duplicated across three columns
Cell in column 1, row 1 |
Cell in column 2, row 1 |
Cell in column 3, row 1 |
Same cell content in columns 1, 2, and 3 |
Same cell content in columns 1, 2, and 3 |
Same cell content in columns 1, 2, and 3 |
Cell in column 1, row 3 |
Cell in column 2, row 3 |
Cell in column 3, row 3 |
Result: Rendered table where cell was duplicated across three columns Cell in column 1, row 1
Cell in column 2, row 1
Cell in column 3, row 1
Same cell content in columns 1, 2, and 3
Same cell content in columns 1, 2, and 3
Same cell content in columns 1, 2, and 3
Cell in column 1, row 3
Cell in column 2, row 3
Cell in column 3, row 3
To have a cell span multiple, consecutive columns, prefix the | with the span factor and the + operator.
Cell spanning three columns
Cell in column 1, row 1 |
Cell in column 2, row 1 |
Cell in column 3, row 1 |
Content in a single cell that spans columns 1, 2, and 3 |
||
Cell in column 1, row 3 |
Cell in column 2, row 3 |
Cell in column 3, row 3 |
Result: Rendered table where cell spans three columns Cell in column 1, row 1
Cell in column 2, row 1
Cell in column 3, row 1
Content in a single cell that spans columns 1, 2, and 3
Cell in column 1, row 3
Cell in column 2, row 3
Cell in column 3, row 3
If you want to have a cell span multiple, consecutive rows, prefix the span factor with a dot (.).
Cell spanning two rows
Cell in column 1, row 1 |
Cell in column 2, row 1 |
Cell in column 3, row 1 |
Content in a single cell that spans rows 2 and 3 |
Cell in column 2, row 2 |
Cell in column 3, row 2 |
Cell in column 2, row 3 |
Cell in column 3, row 3 |
Result: Rendered table where a cell spans two rows Cell in column 1, row 1
Cell in column 2, row 1
Cell in column 3, row 1
Content in a single cell that spans rows 2 and 3
Cell in column 2, row 2
Cell in column 3, row 2
Cell in column 2, row 3
Cell in column 3, row 3
Of course you can combine spanning over columns and rows. The number before the dot (.) is the number of columns to span and the number after the dot (.) is the number of rows to span.
Cell spanning columns and rows
Column 1, row 1 |
Column 2, row 1 |
Column 3, row 1 |
Column 4, row 1 |
Column 1, row 2 |
Content in a single cell that spans over rows and columns |
Column 4, row 2 |
|
Column 1, row 3 |
Column 4, row 3 |
||
Column 1, row 4 |
Column 4, row 4 |
||
Result: Rendered table where a cell spans over columns and rows Column 1, row 1
Column 2, row 1
Column 3, row 1
Column 4, row 1
Column 1, row 2
Content in a single cell that spans over rows and columns
Column 4, row 2
Column 1, row 3
Column 4, row 3
Column 1, row 4
Column 4, row 4
The alignment component for cells works the same as the column specifier alignment component.
NACH_OBEN_PFEILE:
<<㚎>>
^
<<⯅>>
U+1402 ᐂ Kanadisches Silbenzeichen Aai
U+21C8 ⇈ Gepaarte Pfeile nach oben HTML dezimal: ⇈ HTML hex: ⇈
U+21EE ⇮ Dicker weißer Pfeil nach oben HTML dezimal: ⇮ HTML hex: ⇮
U+22BC ⊼ Nand-verknüpft mit HTML dezimal: ⊼ HTML hex: ⊼
U+234D ⍍ APL-Funktionssymbol Quadrat mit Delta HTML dezimal: ⍍ HTML hex: ⍍
U+2397 ⎗ Vorherige Seite HTML dezimal: ⎗ HTML hex: ⎗
U+23BD ⎽ Horizontale Rasterlinie-9 HTML dezimal: ⎽ HTML hex: ⎽
U+23EB ⏫ BLACK UP-POINTING DOUBLE TRIANGLE HTML dezimal: ⏫ HTML hex: ⏫
U+27F0 ⟰ Vierfacher Pfeil nach oben HTML dezimal: ⟰ HTML hex: ⟰
U+290A ⤊ Sehr dicker Pfeil nach oben HTML dezimal: ⤊ HTML hex: ⤊
U+2949 ⥉ Pfeil nach oben mit doppelter Pfeilspitze von kleinem Kreis HTML dezimal: ⥉ HTML hex: ⥉
U+29CB ⧋ Dreieck mit Unterstrich HTML dezimal: ⧋ HTML hex: ⧋
U+2A39 ⨹ PLUS SIGN IN TRIANGLE HTML dezimal: ⨹ HTML hex: ⨹
U+2A5E ⩞ LOGICAL AND WITH DOUBLE OVERBAR HTML dezimal: ⩞ HTML hex: ⩞
U+2B06 ⬆ Schwarzer Pfeil nach oben zeigend HTML dezimal: ⬆ HTML hex: ⬆
U+2B11 ⬑ Pfeil nach links und dann oben zeigend HTML dezimal: ⬑ HTML hex: ⬑
U+2B71 ⭱ HTML dezimal: ⭱ HTML hex: ⭱
U+2B89 ⮉ HTML dezimal: ⮉ HTML hex: ⮉
U+2B6B ⭫ HTML dezimal: ⭫ HTML hex: ⭫
U+2B9D ⮝ HTML dezimal: ⮝ HTML hex: ⮝
U+2BC5 ⯅ HTML dezimal: ⯅ HTML hex: ⯅
U+2BED ⯭ HTML dezimal: ⯭ HTML hex: ⯭
U+3403 㐃 HTML dezimal: 㐃 HTML hex: 㐃
U+368E 㚎 HTML dezimal: 㚎 HTML hex: 㚎
[[㚎]] = ANKER
<<㚎>> = INTERN_VERWEIS
:: U+2423 ␣ open box Die offene Schachtel wird beispielsweise in Softwaredokumentation verwendet, um ein Leerzeichen grafisch darzustellen. Sie wird auch in den meisten Handytastaturen dafür benutzt. :: Einsatz in HTML und Verwandten mit CSS Mehrere aufeinanderfolgende Leerzeichen im Quelltext von HTML- und ähnlichen Dokumenten werden als ein einzelnes Leerzeichen in der Seite von einem Webbrowser ausgegeben, wenn es nicht explizit verhindert wird. Mit der CSS-Eigenschaft white-space und dem Wert pre-wrap (white-space:pre-wrap) geschieht dies.
Der typographische Weißraum kann hier durch Spationierung bzw. Sperrung oder Skalierung eines Leerzeichens mittels CSS definiert werden. Für den Wortabstand existiert die CSS-Eigenschaft word-spacing und für den Zeichenabstand letter-spacing; sie akzeptieren nummerische Werte gefolgt von einer Maßangabe wie px, ex, em, rem, pt, …
Beispiel Wortabstand:
<div style="word-spacing:2em">Dieser Satz zeigt großen Wortabstand.</div> erzeugt: Dieser Satz zeigt großen Wortabstand. Beispiel Zeichenabstand:
<div style="letter-spacing:1ex">Dieser Satz zeigt großen horizontalen Zeichenabstand.</div> erzeugt: Dieser Satz zeigt großen horizontalen Zeichenabstand. ::
-
Eingekreistes:
Tensorprodukt, Vektor, der in Seite zeigt U+2297
Kopieren und einfügen ⊗ Technical information Name Circled Times Unicode-Nummer U+2297 HTML-Code ⊗ CSS-code \2297 Mnemonik ⊗ Block Mathematische Operatoren Unicode-Version: 1.1.5 (1993) Eintragung des Zeichens in verschiedenen Schriftarten ⊗Ihrem Browser ⊗Arial ⊗Times New Roman Charakterbeschreibung Eingekreiste Zeiten. Mathematische Operatoren. Related characters ⛒ Eingekreiste Querstraßen ⨂ N-Ary Circled-Times-Operator ⮾ Eingekreistes X
Codierung Codierung hex dec (bytes) dec binary UTF-8 E2 8A 97 226 138 151 14846615 11100010 10001010 10010111 UTF-16BE 22 97 34 151 8855 00100010 10010111 UTF-16LE 97 22 151 34 38690 10010111 00100010 UTF-32BE 00 00 22 97 0 0 34 151 8855 00000000 00000000 00100010 10010111 UTF-32LE 97 22 00 00 151 34 0 0 2535587840 10010111 00100010 00000000 00000000
Eingekreiste Punktoperator direktes Produkt, Vektor, der aus der Seite heraus zeigt U+2299
Kopieren und einfügen ⊙ Technical information Name Circled Dot Operator Unicode-Nummer U+2299 HTML-Code ⊙ CSS-code \2299 Block Mathematische Operatoren Unicode-Version: 1.1.5 (1993) Eintragung des Zeichens in verschiedenen Schriftarten ⊙Ihrem Browser ⊙Arial ⊙Times New Roman Charakterbeschreibung Eingekreiste Punktoperator. Mathematische Operatoren. Related characters ʘ Lateinischer Buchstabe Bilabial Click ☉ Sonne ⨀ N-Ary Circled-Punkt-Operator
Codierung Codierung hex dec (bytes) dec binary UTF-8 E2 8A 99 226 138 153 14846617 11100010 10001010 10011001 UTF-16BE 22 99 34 153 8857 00100010 10011001 UTF-16LE 99 22 153 34 39202 10011001 00100010 UTF-32BE 00 00 22 99 0 0 34 153 8857 00000000 00000000 00100010 10011001 UTF-32LE 99 22 00 00 153 34 0 0 2569142272 10011001 00100010 00000000 00000000
==== asciiDOC_DOKUMENT_IN_DER_IT-WELT:
BEACHTE:
• Unter "WEBintegration" wird hier verstanden:
• • Beschreibung der asciiDOs Unterstützung, …
• • • … um ein eigenes Dokument ins Web zu stellen …
• • • … und mit dem Web zu "verzahnen".
• Unter "WEBintegration" wird NICHT verstanden:
• • vorliegendes asciiDOC_MIDIspick ins Web zu stellen!!!
RECHNER:
NETZWERK:
WEB:
MOBIL_OVER_ALL:
DOKUMENT_SICHERUNG:
DOKUMENT_AUSGABEN:
ENDE DES DOKUMENTES: "MIDI_SPICKZETTEL_asciiDOC"
= _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _