

PHP TEXTBLOGGER



TextBlogger ist ein kleines und sehr einfaches PHP-Blogsystem:

- 	Der Inhalt befindet sich in einer einzigen Textdatei,
	die per FTP hochgeladen und so aktualisiert wird.

- 	Diese kann sich irgendwo auf den Server befinden.
        [Theoretisch sogar auf irgendeinem Server, falls das entsprechend konfiguriert werden darf]
        [Damit ist die Quelle zwar immer aktuell, aber das Zusammenspiel der Server klappt nicht immer]

-	Getestet wurde das System bis 500 kb Text, unterteilt in 70 Kapitel;
	das entspricht ca. 160 DinA4-Seiten durchsuchbaren Text.

Grere Textmengen, aber auch grere Unterteilung in Seiten oder Kapitel
(oder zu geringe!), verlangsamen die Darstellung deutlich - irgendwann bis zum Stillstand.



<UL>

<LI>  	Die Textdatei kann zustzlich mit normalen HTML-Befehlen versehen werden,
		Beispielsweise um diese Liste zu erstellen.

<LI>  	Auch eine reine <A HREF="#SU1">HTML-Datei</A> kann verarbeitet werden

<LI> 	Unterteilt in einzelne Web-Seiten wird der Text durch das Einfgen eines eigenen HTML-Befehls, der allerdings alleine stehen mu.

</UL>



Zum Beispiel HIER (weiter auf der <A HREF="#SU1">nchsten Seite</A>)


	<!- SEITENUMBRUCH ->


<WBR SU1> Der Seitenumbruch


Um den

'SEITENUMBRUCH' - Tag

zu erkennen, mu man die <A HREF="_inhalt/textblogger.txt">Textdatei selber</A> aufrufen.


[Achtung: Leere Seiten oder Seiten mit nur einem Titel als Inhalt fhren evtl. zu Problemen. Daher ggf. unter der einzigen Zeile mindestens vier Leerzeilen einbauen.
Nachtrag: Dieses Problem ist in Angriff genommen worden]


Neben speziell erstellten Textseiten

<LI> 	lassen sich auch automatisch generierte HTML-Seiten einlesen, wobei beispielsweise < HR >  als Seitenumbruch genommen werden kann, wenn dieser Tag dort im Quelltext immer alleine in einer Zeile steht.

[Beim Auslesen von HTML-Dateien sollte in der Konfigurationsdatei unter 'Erlaubte oder verbotene Zeichen' das Semikolon erlaubt werden, um Umlaute korrekt darzustellen; es empfiehlt sich auerdem, die Position des Inhaltsverzeichnisses auf "rechts" zu setzen und die Position der Text-Scrollbar in der CSS-Datei auf "rechtsseitig" zu belassen, da die seitenspezifischen HTML-Tags sich sonst rechtsbndig orientieren; ggf. mssen einzelne HTML-Tags noch zustzlich in der CSS-Datei gesondert formatiert werden]

<LI>	<A HREF="http://www.erleuchtet.kilu.de/tl-demo/cuetest/textblogger.php">hier getestet bis 300 kb</A>.


- weiter auf der <A HREF="#SU2">nchsten Seite</A>


	<!- SEITENUMBRUCH ->


<WBR SU2> Eigenschaften und Formatierung

Die Eigenschaften dieses PHP-Blogsystems:


- 	Es gibt nur einen einzigen zusammenhngenden Text,
	der leicht zu verndern ist.

- 	Auch die Seiten-Umbrche knnen einfachst um- und neugesetzt werden,
	beispielsweise wenn eine Seite zu lang geworden ist.

- 	Diese Seiten sind bertrieben Formatiert, um die Mglichkeiten darzustellen.
	Eine derartig farbige Darstellung ist nicht ntig und kann in der CSS- Datei
	in weiten Teilen nach Belieben eingestellt werden.



Die Maschine macht den Rest. Auch die Seitenanzahl wird automatisch aktualisiert.

- 	Hier ist noch ein Satz beziehungsweise Absatz mit mglichst vielen Wrtern ohne einen Zeilenumbruch, um zu zeigen, wie der Text dann automatisch umgebrochen wird, wenn er nicht schon im Original umgebrochen wurde.


Aufgerufen wird PHP TEXTBLOGGER ber die PHP-Datei im Hauptverzeichnis, im Original "TEXTBLOGGER.PHP".


<WBR Gesteuert1>Gesteuert wird das Aussehen und das Verhalten ansonsten mit
JavaScript (in der Datei "<A HREF="_konfiguration/textblogger-js.js">TEXTBLOGGER-JS.JS</A>")
und CSS (in der Datei "<A HREF="_konfiguration/textblogger-css.css">TEXTBLOGGER-CSS.CSS</A>"),


sowie der Konfigurationsdatei

"<A HREF="_konfiguration/tb-konfiguration.incl">tb-konfiguration.incl</A>"


in der auch andere grundlegende Angaben gemacht werden, wie beispielsweise Pfad und Name der auszulesenden Text-Datei fr den Inhalt.

(hier: "<A HREF="_inhalt/textblogger.txt">TEXTBLOGGER.TXT</A>").


- Die Datei "<A HREF="tb_konfigurations-anzeiger.php">TB_KONFIGURATIONS-ANZEIGER.PHP</A>" ist fr den Betrieb selbst nicht notwendig - sie dient lediglich zum Auslesen der Konfiguration von TextBlogger.


- Alle dazu relevanten Dateien befinden sich im Unterverzeichnis '/_konfiguration',
whrend sich die Inhalte in '/_inhalt' befinden.





Wenn die CSS-Werte entsprechend eingestellt sind,
bestimmt auch der Abstand der Abstze in der Textdatei deren Formatierung.
Die folgende Zeile hat zur jeweils vorhergehenden einen Abstand von

einer Leerzeile ( = Neuer Absatz )


zwei Leerzeilen ( = Standard-Text mit Abstand )



drei Leerzeilen ( = Fett Schwarz .  mit Abstand )




vier Leerzeilen ( = Fett Blau .  mit Abstand )





fnf Leerzeilen ( = Neuer Absatz )






usw. Deshalb darauf achten, da der Flietext ohne versteckte, ungewollte Umbrche verluft, denn diese werden -anders als in HTML- automatisch angezeigt bzw. umformatiert.




Ebenso lassen sich mit dem PRE - Tag Tabellen und Aufzhlungen darstellen:

<PRE>

Das 		ist    		zunchst eine  		ERSTE 		Zeile
Es    		folgt		dann eine      		ZWEITE 		Zeile

</PRE>




<!- SEITENUMBRUCH ->


Bilder, Dateien, Verweise



Bilder lassen sich einfgen:

<IMG SRC="_inhalt/jhr.gif" ALIGN="TOP" HSPACE="10" VSPACE="10"> <BR clear=all>

Groe Bilder fhren allerdings dazu, da der nachfolgende Text sich unter Umstnden wild um das Bild verteilt und nur durch endlos langen Abstand nach unten in der Textdatei daran gehindert werden kann.

Es gengt jedoch wie hier hinter den Bild-Aufruf den alten HTML-Befehl


< BR clear=all >

hinter oder unter das Bild zu setzen, und der Text wird unter dem Bild fortgesetzt. Bei Bildern im HTML generell nur die geforderte (falls von der Original-Gre abweichende) Anzeigen-Breite (WIDTH) festlegen, sonst kann es in manchen Browsern zu Verzerrungen kommen.
[Alternativ oder zustzlich dazu kann das Verhalten der Bilder in der CSS-Datei beeinflut werden; dieses wurde jedoch noch nicht implementiert]

Ab <A HREF="textblogger.php#Versionsgeschichte">Version 2.0</A> knnen absolute Verweise und Bildverweise im Text -also alles, was mit HTTP://... beginnt- automatisch in aktive Verweise umgewandelt werden; Bilder in Verweisen werden dann ggf. automatisch angezeigt.


[Die Bilder verweisen dabei automatisch auf sich selbst]
[Zugehrige Variable in der Konfigurationsdatei: JSVar2]


http://www.erleuchtet.kilu.de/neu.gif

http://.www.ein_test.de
http://.www.nocheintest.de

[Unter Umstnden (je nach Konfiguration) mssen dazu die URLs im Text alleine stehen, d. h. vorne und hinten durch Leerzeichen oder Zeilenumbrche abgegrenzt sein]

Es ist also nicht mehr notwendig, Bilder oder URLs in HTML zu formatieren, wenn diese absolut adressiert werden knnen.

[Das gilt nicht fr relative Adressierte URLs oder Bilder; diese mssen weiterhin in HTML formatiert werden, wenn sie aktiv sein sollen]

Auch das einbinden anderer Dateien ist mglich
und einfach mit HTML zu bewerkstelligen.



Beispielsweise befindet sich das TextBlogger- System


Hier zum <A HREF="http://www.erleuchtet.kilu.de/fw/alg/textblogger.zip">herunterladen</A> (ZIP-Archiv, ca. 20 kb)


<WBR ZA1>TextBlogger lt sich ohne weiteres mit anderen Styles belegen oder kombinieren,  <A HREF="http://www.erleuchtet.kilu.de/tl-demo/textblogger/textblogger_ctr.php">wie zum Beispiel hier</A> mit <A HREF="http://www.erleuchtet.kilu.de/hilfe/autoform.htm#oben" TARGET="page">Autostyle</A>.


Dazu mu lediglich eine weitere Script-Datei in der TEXTBLOGGER.PHP angegeben werden, unterhalb der bereits notierten <A HREF="#Gesteuert1">textblogger-js.js</A> - oder in der bereits erwhnten "<A HREF="#Gesteuert1">tb-konfiguration.incl</A>".


- Die PHP-Umgebung sorgt nur fr die Schale.

- Bentigt wird lediglich ein PHP- fhiger Server mit FTP-Zugang.



<!- SEITENUMBRUCH ->


Interne Verweise


Ab TextBlogger <A HREF="textblogger.php#Versionsgeschichte">Version 1.3</A> kann mit ganz normalen Zielanker- Verweisen


(A HREF="#AnkerNr")


gearbeitet werden; zustzlich knnen genau so bestimmte (einzelne!) Begriffe irgendwo im Inhalt


(mit A HREF="#Begriff")


angesprochen werden.

In dem Fall werden, einer Suche entsprechend, alle Seiten mit diesem Begriff angezeigt, und der erste auf der Seite wird angesprungen.


ACHTUNG: Abweichend vom normalen HTML mu in TextBlogger der Anker IM TEXT nicht mit

< A Name="AnkerNr" >


angegeben werden, sondern zwingend in der Schreibweise

< WBR AnkerNr >


- mit einem Leerzeichen nach dem WBR und ohne Zeilenumbruch.


(Nach dem < und vor dem > wie blich KEIN Leerzeichen! Hier sind sie nur aus technischen Grnden abgetrennt)


[Genauer: <WBR AnkerNr> - der doppelt belegte A-Tag (HREF bzw. NAME)
kann whrend der Begriffsuche auerhalb der HTML-Tags nicht nach HREF oder NAME aufgelst werden]


(<A HREF="_inhalt/textblogger.txt">Hier nachsehen</A>)

Im < WBR AnkerNr > sollten keine Umlaute oder Sonderzeichen verwendet werden




Anmerkung:

1) Den Ziel-Anker nicht allein in eine eigene Zeile setzen!
(Gilt dann als eine leere Textzeile)

2) Da der Ziel-Anker ggf. in der Sucheingabe angezeigt wird, sollte er die Mindestanzahl an Zeichen haben, die in der <A HREF="_konfiguration/textblogger-js.js">TEXTBLOGGER-JS.JS</A> als "var Minimum" angegeben ist -
(Voreinstellung: 3)

3) Keine Umlaute oder Sonderzeichen im Anker verwenden! Darber hinaus sollte die Zeichenfolge im sonstigen Text nicht vorkommen, da sonst beide ausgegeben werden- also am besten eine regelmige Buchstaben- Zahlenkombination - auer "WBR"(!)

4) Nach Gro- und Kleinschreibung wird in der Suche nicht unterschieden




<!- SEITENUMBRUCH ->

Wozu das Ganze?

Eines der wichtigsten Vorteile ist, da bei einem Datenverlust, Absturz oder Systemwechsel alle Informationen nach wie vor zusammenhngend in einer einzigen Datei vorliegen (wenn man sie denn irgendwo so gesichert hat) und nicht erst mhselig wieder zusammengekratzt und neu aufgebaut werden mssen.

Ggf. notwendige Anpassungen, wie die nderungen von Adressen etc., knnen durch Suchen & Ersetzen schnell und zentral vorgenommen werden.




Besonderheiten:

<UL>

<LI> 	Ein Nachteil ist, wie bei allen Datenbank- und PHP- generierten Seiten, da der Inhalt von den Suchmaschinen wie Google nicht unbedingt gefunden wird - es sei denn, man verweist irgendwo von der Hauptseite auf die Original-Textdatei.

<LI> 	Gedruckt wird immer nur der ohne Scrollen sichtbare Teil. Soll also das vollstndige Drucken ermglicht werden, mu der Text in entsprechend kleine Teile aufgeteilt, oder das Scrollen im Textbereich ausgeschaltet werden.

<LI> 	Beim Speichern als vollstndige Webseite werden alle Inhalte der jeweiligen Seite inklusive der Bilder auf der Festplatte abgelegt und knnen von dort aus auch gedruckt werden.


</UL>




<!- SEITENUMBRUCH ->

Schlubemerkung (Versionsgeschichte):

Verfgbar in:

- Version 2.0 (eingestellt)

- Version 3.0x (<A HREF="textblogger.php#Bilder">mit Suche und internen Verweisen</A>)

[Die Suche und einiges Andere lt sich in der <A HREF="#Gesteuert1">Konfigurationsdatei</A> abschalten, um ein umfangreicheres Inhaltsverzeichnis zu ermglichen]


<U>Anmerkung</U>: In der Version 3.03 c hatte sich ein grober Fehler eingeschlichen, der jetzt hoffentlich beseitigt ist
[Bei der Darstellung ohne Seitentitel wurde die erste Seite nicht angezeigt]

Achtung: Textblogger wurde umgebaut und mu ggf. vllig neu auf dem Server installiert werden. Der bisherige Aufbau ist ungltig. Der Inhalt kann natrlich <A HREF="#Systemwechsel">erhalten bleiben</A>.




- Version 4.0 x (Umgestellt auf PHP 5.6)

[Version 4.0 b: Fehler bei der Suche nach Umlauten in HTML-Quellen beseitigt.
Es gelten allerdings nur deutsche Sonderzeichen. Ggf. mssen diese in der "<A HREF="_konfiguration/tb-konfiguration.incl">tb-konfiguration.incl</A>" ergnzt werden]

[Version 4.0 c: Weitere Fehler durch die Umstellung auf PHP 5.6 beseitigt. War das wirklich notwendig?]


- Hier zum <A HREF="http://www.erleuchtet.kilu.de/fw/fw-index.htm#Blogt">herunterladen</A> (ZIP-Archiv, ca. 30 kb)





"Was immer dein Rechner kann, er kann es besser als Du!"


<A HREF="#ZA1">JHR</A> 2014



