1
2

Zmienna <span class=\"zmienna\">$plk</span> przechowuje...
...zawartość pliku <span class=\"plik\">dane.txt</span>.

1
2
3
4
5
6
7

<DIV class=\"listing\">
<PRE>
BODY {
background : rgb(215,251,226);
text-align : center;
margin : 50px;
}

1
2
3
4
5
6
7

<DIV class=\"ilustracja\">
<IMG src=\"ilustracje/12-06.png\" alt=\"\">
<P class=\"podpis\">
Rys. 6. Strona główna witryny
<SPAN class=\"zmienna\">http://gwz.gajdaw.pl</SPAN>
</P>
</DIV>

Struktura skryptu modyfikującego artykuł
Każdy ze skryptów modyfikujących artykuły działa w oparciu o ten sam schemat przetwarzania. Najpierw ustalane są nazwy plików, jakie należy poddać przekształceniu. Do tego celu wywołuję funkcję {stala}glob(){/stala}:

1

$pliki = glob(\'artykuly/a*.txt\');

Następnie w pętli foreach przetwarzam wszystkie pliki, których nazwy są zawarte w tablicy $pliki. Wewnątrz pętli każdy artykuł jest odczytywany funkcją {stala}file_get_contents(){/stala}, przetwarzany oraz zapisywany (wywołanie
{stala}file_put_contents(){/stala}):

1
2
3
4
5

foreach ($pliki as $plik) {
$tmp = file_get_contents($plik);
$html = htmlTagsToLower($tmp);
file_put_contents($plik,$html);
}

Powyższy kod wykonuje konwersję wielkości liter w znacznikach HTML. Funkcja {stala}htmlTagsToLower(){/stala} pobiera jako parametr napis zawierający kod HTML artykułu. Wynikiem działania funkcji jest kod HTML po odpowiedniej
konwersji. Do konwersji dokumentu stosuję zazwyczaj dedykowane funkcje zajmujące się jedną z transformacji. Oprócz wymienionej już funkcji {stala}htmlTagsToLower(){/stala} w skryptach odpowiedzialnych za naprawę kodu

HTML zawarto między innymi funkcje {stala}html­GetBody(){/stala}, {stala}pl_win2iso(){/stala}, {stala}htmlDe­leteComments(){/stala}, {stala}htmlTagsToLo­wer(){/stala} oraz {stala}htmlCorrectBr(){/stala}. Listing 7 przedstawia skrypt, który wstawia do wszystkich artykułów spis treści.

1
2
3
4
5
6
7
8
9
10
11
12
13

$pliki = glob(\'artykuly/a*.html\');
foreach ($pliki as $plik) {
  echo $plik . \"\n\";
  $tmp = file_get_contents($plik);
  $tablicaTOC = getTableOfContents($tmp);
  $napisTOC = getTableOfContentsAsString($tablicaTOC);
  $tmp = addID($tablicaTOC, $tmp);
  preg_match(\"|(<p class=\\"lid\\">.*</p>)[\n\r\t ]*(<h3[^>]*>.*</h3>)|Usim\", $tmp, $m);
  $tmp = str_replace($m[1], $m[1] . \"\r\n\r\n\r\n\" . $napisTOC . \"\r\n\r\n\r\n\", $tmp);
  file_put_contents($plik,$tmp);
  flush();
  ob_flush();
}

Trzy etapy przygotowania artykułu

Ujednolicenie formatu HTML

Pierwszym etapem przetwarzania artykułów jest ujednolicenie i naprawienie kodu HTML. Nale­ży dążyć do tego, aby artykuł zawierał poprawny kod XHTML 1.0, zgodny z formatem narzuconym przez redakcję. Zadanie to wygodnie jest wykonać etapami:

1. Wycięcie treści strony (tj. zawartość elementu body).
2. Konwersja polskich znaków.
3. Usunięcie komentarzy HTML.
4. Sprawdzenie poprawności użycia znaków {html}<{/html} oraz {html}>{/html} (na tym założeniu opierają się dalsze algorytmy).
5. Konwersja znaczników HTML: duże litery w małe (zamiast {html}
   -
   {/html}).
6. Ustalenie listy wszystkich użytych znaczników HTML.
7. Naprawa:
   1. BR
   2. IMG
   3. PRE
   4. THEAD
   5. Usunięcie {html}BR BR{/html}
   6. Modyfikacja ścieżek w elementach IMG
8. Standaryzacja znaczników
9. Trim zawartości elementów P i PRE
10. Przygotowanie stron do walidacji

Powyższa procedura jest oczywiście ukierunkowana
na naprawienie i ujednolicenie konkretnych tekstów (tj. artykułów wymienionych i opisanych w poprzednim punkcie). W przypadku innych tekstów
(złożonych w inny sposób, stosujących inne konwencje, elementy HTML i formaty) procedura ta ulec może pewnym zmianom. Uniwersalne wydają mi się kroki od pierwszego do szóstego oraz krok dziesiąty.

Po wykonaniu pierwszych czterech kroków będziesz
dysponować treścią artykułów pozbawioną komentarzy HTML i zaopatrzoną w odpowiednie ogonki. Co więcej, krok 4 gwarantuje, że dalsze przetwarzanie może opierać się na założeniu, że znaki {html}<{/html} oraz {html}>{/html} są poprawnie użyte. Z kolei krok piąty, konwersja liter dużych na małe w znacznikach
HTML, jest pierwszym etapem konwersji dokumentów HTML na XHTML.

Ujednolicenie formatu artykułów wymaga stwierdzenia, jakie znaczniki zostały wykorzystane
w artykule. Na to pytanie odpowiada skrypt z kroku szóstego. Wyznacza on listę wszystkich wykorzystanych
elementów HTML. Na tej podstawie można przekształcić teksty do spójnego formatu. Jeśli na przykład dostrzeżesz użycie elementów B, możesz je automatycznie przekonwertować na STRONG. Podobnie należy postąpić z elementami stosującymi niedozwolone klasy lub identyfikatory.

Kroki 7, 8 oraz 9 naprawiają kod HTML i konwertują
dokument do języka XHTML. Są to skrypty

przeznaczone do naprawy konkretnych artykułów. Nie są one uniwersalne. Wraz ze zmianą artykułów skrypty te należy wymienić. Wreszcie ostatni krok przygotowuje kompletne dokumenty XHTML przeznaczone do walidacji. W artykułach pojawiają się hiperłącza:

1
2

<a href=\"http://validator.w3.org/check?uri=referer\">HTML</a>
<a href=\"http://jigsaw.w3.org/css-validator/check/referer\">CSS</a>

ułatwiające walidację kodu XHTML. Jeżeli walidacja
dokumentu przebiegnie poprawnie, to można uznać, że artykuł został naprawiony.
Wszystkie opisane powyżej kroki wykonuje się, stosując funkcje do przetwarzania napisów oraz wyrażenia regularne. Na przykład krok pierwszy, wycięcie treści dokumentu, realizuje funkcja {stala}htmlGetBody() {/stala}przedstawiona na listingu 3.

1
2
3
4
5
6
7
8

function htmlGetBody($AStr)
{
if (preg_match(\"|<body>(.*)</body>|Uis\", $AStr, $matches)) {
return $matches[1];
} else {
return false;
}
}

Numeracja rozdziałów

Przystępując do numerowania rozdziałów zakładam, że walidacja dokumentu przebiegła poprawnie. Do oznaczenia rozdziałów i podrozdziałów
w artykułach stosuję elementy h3 oraz h4. Wynika to z faktu, że elementy h1 oraz h2 zarezerwowałem do oznaczenia tytułu oraz autora artykułu. W przypadku stosowania elementów różnych od h3 i h4 do określania struktury tekstu (czyli podziału na rozdziały) podane rozwiązanie należy nieco zmodyfikować.

Fragment jednego z artykułów został przedstawiony
na listingu 4. Wcięcia kodu HTML uwypuklają
strukturę tekstu. Dla przejrzystości, listing ten zawiera wyłącznie tytuły rozdziałów i podrozdziałów
(usunięto z niego treść).

Tekst ten należy oznaczyć, stosując numerację dwupoziomową: numer rozdziału i numer podrozdziału
oddzielone kropką.

Wynik numerowania przykładu z listingu 4 jest widoczny w ramce.

Numerowanie przebiega w dwóch etapach. Najpierw ustalana jest struktura tekstu.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<h3>Strony WWW</h3>
<h3>Języki znacznikowe</h3>
<h3>Składnia języka HTML 4.01</h3>
<h4>Znaczniki i elementy</h4>
<h4>Znaki specjalne</h4>
<h4>Zagnieżdżanie znaczników</h4>
<h4>Znaczniki wymagane...</h4>
<h4>Białe znaki w dokumencie HTML</h4>
<h4>Atrybuty znaczników</h4>
<h4>Komentarze w HTML</h4>
<h3>Struktura dokumentu HTML</h3>
<h4>Wersje języka HTML...</h4>
<h4>Nagłówek strony WWW</h4>
<h4>Treść dokumentu</h4>
<h3>Podsumowanie</h3>

Zadanie to realizuje funkcja {stala}getTableOfContents().{/stala} Stosując wyrażenia regularne, dokonuje ona analizy
tekstu i w wyniku zwraca tablicę, która opisuje podział dokumentu na rozdziały i podrozdziały.
Po wywołaniu:

1
2
3
4

$tmp[1][0] = Strony WWW
$tmp[2][0] = Języki znacznikowe
$tmp[3][0] = Składnia języka HTML 4.01
...

Jeśli wybrany rozdział zawiera podrozdziały, wówczas tytuły podrozdziałów znajdziesz w dalszych
składowych tablicy {stala}$tmp{/stala}, na przykład:

1
2
3
4

$tablica[3][1][1] = Znaczniki i elementy
$tablica[3][1][2] = Znaki specjalne
$tablica[3][1][3] = Zagnieżdżanie znaczników
...

Wynik działania funkcji {stala}getTableOfContents(){/stala}
jest przekazywany, wraz z samym artykułem, do funkcji {stala}renumberChapters(){/stala}:

Funkcja{stala} renumberChapters(){/stala} wstawia numery rozdziałów i podrozdziałów. Wewnątrz funkcji, na podstawie tablicy {stala}$tablicaTOC{/stala}, wywoływana jest {stala}funkcja str_replace(){/stala} z odpowiednimi parametrami:

1
2
3

$result = str_replace(\"<h3>{$ATocArray[$i][0]}</h3>\",\"<h3>{$i}. {$ATocArray[$i][0]}</h3>\",
$result
);

Pełny kod funkcji wstawiającej numery stron został przedstawiony na listingu 6.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

function renumberChapters($ATocArray, $AText)
{
  $result = $AText;
  $ile = count($ATocArray);
  for ($i = 1; $i <= $ile; $i++) {
    $result = str_replace(\"<h3>{$ATocArray[$i][0]}</h3>\", \"<h3>{$i}. {$ATocArray[$i][0]}</h3>\", $result);
    $ilePodr = count($ATocArray[$i][1]);
    if ($ilePodr > 0) {
      for ($j = 1; $j <= $ilePodr; $j++) {
        $result = str_replace(\"<h4>{$ATocArray[$i][1][$j]}</h4>\", \"<h4>{$i}.{$j} {$ATocArray[$i][1][$j]}</h4>\", $result);
      }
    }
  }
return $result;
}

Spis treści

Praca nad spisem treści, podobnie jak numerowanie rozdziałów, wymaga znajomości struktury tekstu. Wykorzystam do tego omówioną
już funkcję {stala}getTableOfContents(){/stala}. Utworzenie spisu treści polega na wykonaniu trzech operacji:

• po pierwsze, trzeba oznaczyć rozdziały i podrozdziały
  identyfikatorami id;
• po drugie, należy ustalić kod HTML spisu treści,wreszcie po trzecie, kod spisu treści musi zostać umieszczony w artykule.

Najpierw stwórz tablicę $tablicaTOC opisującą strukturę tekstu:

1

$tablicaTOC = getTableOfContents ($tmp);

Następnie na podstawie tablicy $tablicaTOC
w zmiennej $napisTOC stwórz kod HTML spisu treści:

1

$napisTOC = getTableOfContentsAsString($tablicaTOC);

Teraz w artykule dodaj atrybuty id elementom h3 oraz h4:

1

$tmp = addID($tablicaTOC, $tmp);

Każdy rozdział oznaczony elementem {html}h3{/html} otrzyma identyfikator RX, gdzie X jest numerem rozdziału. Na przykład rozdział trzeci, zatytułowany "Składnia języka HTML 4.01", otrzyma identyfikatorR3:

1

<h3 id=\"R3\">3. Składnia języka HTML 4.01</h3>

Natomiast podrozdziały otrzymują identyfikatory
PX-Y (X to numer rozdziału, Y to numer podrozdziału). Podrozdział 3.2 zatytułowany "Znaki specjalne " otrzymuje identyfikator P3-2:

1

<h4 id=\"P3-2\">3.2 Znaki specjalne</h4>

Na koniec, kod HTML spisu treści, zawarty w zmiennej {stala}$napisTOC{/stala}, umieść w artykule:

1
2

preg_match(\"|(<p class=\\"lid\\">.*</p>)[\n\r\t ]*(<h3[^>]*>.*</h3>|Usim\", $tmp, $m);
$tmp = str_replace( $m[1], $m[1] . \"\r\n\r\n\r\n\" . $napisTOC . \"\r\n\r\n\r\n\", $tmp);

Kompletna procedura wstawiająca spis treści do wszystkich artykułów została przedstawiona na listingu 8.

Wynikowa strona

Po wykonaniu opisanych trzech przekształceń artykułów możesz przystąpić do przygotowania strony WWW zawierającej artykuły. Witryna ta stosuje szablon przedstawiony na ilustracji 1. Menu główne strony składa się z czterech opcji: "Strona główna", "Artykuły", "Adresy" oraz "Pobierz".
Po wybraniu opcji "Artykuły" pojawia się lista wszystkich artykułów zawartych w serwisie. Każdy artykuł jest oznaczony tytułem, po którym następuje akapit wprowadzający. Niebieska strzałka jest hiperłączem do pełnego tekstu artykułu.

Artykuły stosują numerację rozdziałów, zaś spis treści zawarty na początku artykułu ułatwia poruszanie się po tekście.

Może Cię zainteresować:

1. HTML i formatowanie tekstu
2. PHP – Stronicowanie artykułów
3. Formatowanie kodu PHP