aanmaken van StepCollect-pagina's.
Doelstelling van deze Steples
- Deze steples zal de stappen tonen die dienen gevolgd te worden om pagina's aan te maken startende vanaf een StepCollectie.
Steplessen die best gevolgd zijn vooraleer deze Steples te starten
Voorkennis
- Een werkende kennis van StepGen is vereist.
Licentie
- Een licentie voor de StepCollect-module is vereist.
Logische vervolg
Wat is StepCollect ?
StepCollect is een module van de Sitestepper-software die apart kan worden aangeschaft. Eens een licentie voor deze module is aangeschaft, ontvangt de gebruiker een bijkomende registratiecode dewelke kan worden ingevoerd in het Sitestepper-registratiescherm.
Wat is het doel van StepCollect ?
Het doel in één zin
StepCollect laat de gebruiker toe om een verzameling te publiceren op zijn website.
Verzameling ?
Het woord verzameling wordt in de StepCollect-terminologie in de grote mate van het woord gebruikt.
Met verzameling wordt bedoeld: elke bij elkaar horende set van gegevens dewelke op een website kan worden getoond. Het is het Engelstalige woord voor verzameling 'Collection' die de module StepCollect zijn naam heeft gegeven.
Voorbeelden van verzamelingen:
- Een verzameling CD's.
- Een lijst van boeken.
- Vakantiefoto's van één of meerdere onderwerpen.
- Een agenda.
- Een lijst van oude munten.
- Een verzameling van gehandtekende foto's.
maar ook
- De portfolio van een website.
Tip: De pagina op de Sitesteppersite waar de websites worden getoond die worden onderhouden met Sitestepper is een pagina gegenereerd met de StepCollect-module:
http://www.sitestepper.be/nl/stepcollect---sitestepper-websites-automatic.htm - Een productencataloog.
- Een lijst van stempels.
- ...
Dus alle gegevens die op een gelijkvormige manier getoond dienen te worden op één of meerdere webpagina's.
Waarom niet handmatig de webpagina's invoeren
Natuurlijk kunnen deze verzamelingen door de gebruiker één voor één op één of meerdere webpagina's worden ingevoerd. Sitestepper maakt het immers enorm gemakkelijk om:
- Linken te leggen tussen verschillende pagina's (d.m.v. StepLinks).
- Afbeeldingen op een gelijkvormige manier te importeren (zie 'Werken met afbeeldingen').
Indien de te publiceren verzameling klein is ,of slechts in één taal moet worden gepubliceerd, dan is deze handmatige ingave nog perfect uit te voeren. Net zoals men de linken tussen webpagina's ook handmatig (of hard-coded) kan invoegen op de website, zo kan men , uiteraard, ook deze verzamelingen handmatig invoeren.
Sitestepper zal echter, met de StepCollect module, dit publiceren enorm vereenvoudigen, zodanig dat de gebruiker zeer snel zijn verzamelingen kan aanpassen en/of uitbreiden. In té veel webpagina's wordt éénmalig heel veel werk gestoken om deze mooi te maken, maar worden nadien diezelfde pagina's niet meer aangepast omdat:
- men bang is de bestaande mooie layout te vernietigen
- de handeling te lang duurt
- de handelingen te veel werk vergen om 'snel' even te doen.
De stappen: van StepCollectie tot webpagina's
Schema
Bespreking
Het voorgaande schema toont de verschillende stappen die dienen gevolgd te worden en de verschillende software die dient gebruikt te worden om een verzameling – de stepcollectie – te publiceren op de website.
- Editeer de stepcollectie via het StepCollect-programma.
- Creëer de bronpagina die als basis zal
dienen de te creëren webpagina's. Deze bronpagina dient een
StepCollect-sectie te bevatten die de weergave bevat van één
record van de verzameling.
Dezelfde stepcollectie kan worden gekoppeld aan verschillende bronpagina's, elk met hun eigen uitzicht en elk met een eventueel ingestelde filter (zie punt 6). - Genereer de bronpagina's in de projectboom vertrekkende vanaf de stepcollectie ingevoerd in stap 1 en de geprepareerde bronpagina van stap 2.
- Het resultaat van stap 3 zullen één of meerdere 'normale' bronpagina's in het Sitestepperproject vormen. Elk aangemaakte bronpagina zal een uniek keyword toegewezen krijgen en zal automatisch dezelfde skeleton gebruiken als de bronpagina van de StepCollectie.
- Genereer de site – alle in stap 3 aangemaakte bronpagina's zullen als alle andere bronpagina's worden verwerkt.
- Eventueel kan door middel van een stuurelement worden aangegeven dat niet alle records van de stepcollectie dienen opgenomen te worden in de te genereren pagina, maar slechts een selectie. M.a.w., er kan een filter worden geplaatst op een stepcollectie om slechts een deel van de stepcollectie te tonen op een bepaalde pagina.
- Eventueel kan StepCollect automatisch
steplinken prepareren zodanig dat verschillende bron- of
webpagina's die vertrekken vanaf dezelfde stepcollectie naar elkaar
gelinkt kunnen worden.
Dit wordt meestal gebruikt om op één pagina een overzicht te plaatsen van slechts enkele records uit een stepcollectie, waarbij elk tekst of afbeelding de overzichtspagina een link wordt naar een andere pagina met alle teksten of afbeeldingen van de daarbij horende records.
De volgende hoofdstukken zullen voorgaande 7 punten één voor één bespreken.
Opmerkingen:
- Alhoewel de logische volgorde waarin de handelingen zullen worden uitgevoerd allicht iets anders is dan in voorgaande schema (want meestal zal eerst de bronpagina worden aangemaakt in het Sitestepperproject vooraleer men de stepcollectie al invoeren), toch zullen de stappen worden beschreven in de volgorde als in het schema is aangeduid met de nummers 1 tot 7.
- Na het bespreking van de verschillende punten van het schema, zullen enkele voorbeelden worden getoond. Zoals steeds zijn het vooral voorbeelden die de gebruiker op weg helpen bij het gebruiken van een optie zoals StepCollect. Ondergaande bespreking van de punten kan echter worden gebruikt om een gedetailleerd inzicht te krijgen over hoe StepCollect werkt en waarom StepCollect op een dergelijke manie werkt.
Schema punt 1: Editeer de stepcollectie via het StepCollect programma
De StepCollect-module van de Sitestepper-software biedt de gebruiker de mogelijkheid de verzamelingen in te voeren in een apart programma (StepCollect.exe).
Dit programma, dat wordt gestart vanuit de menu-optie 'Project – Editeer Stepcollectie...', zal een omgeving aanbieden dewelke gebruikers zullen herkennen vanuit andere software (zoals spreadsheets of database-programma's).
Het StepCollect-programma zal de gebruiker de verzameling laten invoeren, aanpassen en uitbreiden zonder dat rekening moet worden gehouden met de uiteindelijke webpagina's waarop de verzameling zal worden getoond.
Informatie
- Net zoals in databaseprogramma's zal in deze handleiding de Engelstalige term 'record' worden gebruikt om één rij aan te duiden van een verzameling.
- Dus een verzameling zal bestaan uit één of meerdere records.
Eén record uit een verzameling
Zoals reeds gezegd, zal een verzameling bestaan uit één of meerdere records.
Elk record, op zijn beurt, zal bestaan uit verschillende velden.
Elk veld is van een bepaald type (tekst, numeriek of datum) wat betekent dat StepCollect niet zal toelaten dat foutieve informatie in de velden wordt ingevoerd. Zo zal het onmogelijk zijn een foutieve of onmogelijke datum in te voeren in een datum-veld, en zal een numeriek veld geen alfabetische tekens kunnen bevatten.
De velden in een StepCollectie
Elk record van een verzameling bevat de volgende velden.
|
Veld |
Verplicht? |
Type |
Omschrijving |
|---|---|---|---|
|
code
(sleutelveld) |
Ja |
Tekst 16 lang |
Dit waarde van dit veld moet uniek zijn over heel de StepCollectie. De waarde van dit veld zal worden gebruikt om de StepCollectie te ordenen (M.a.w. de webpagina's zullen de gegevens tonen alfabetisch gesorteerd op de inhoud van het code-veld). |
|
titel |
Ja |
Tekst 64 lang |
|
|
subtitel |
|
Tekst 64 lang |
|
|
actief |
|
Ja/Nee |
|
|
datum |
|
Datum |
|
|
jaar |
|
Geheel getal |
Alhoewel deze kolom wordt aangeduid als 'jaar', kan hier elk geheel getal tussen +/- 2 miljard worden ingevoerd. |
|
prijs |
|
Valuta veld 2 cijfers |
Deze waarde wordt ingevoerd en getoond met maximum 2 cijfers na de comma. |
|
afbeelding |
|
Tekst 128 lang |
Aan elke record kan een afbeelding worden gekoppeld dewelke kunnen worden geïmporteerd en geselecteerd in exact dezelfde manier als de opties 'Importeer een afbeelding...' en 'Gebruik een bestaande afbeelding...' in het 'Invoegen – Afbeelding invoegen...'menu van StepEdit (waar alle andere bronpagina's worden ingegeven). |
|
vrij tekstveld |
|
Tekst 255 lang |
|
|
vrij datumveld |
|
Datum |
|
|
vrij numeriek veld |
|
Geheel getal |
|
|
omschrijving |
|
Tekst 255 lang |
Dit omschrijvingsveld is beschikbaar in elk van de 8 talen van een Sitestepperproject. De StepCollect-actie zal automatisch de juiste beschrijving (omschrijving) gebruiken bij het genereren van een bronpagina in een bepaalde taal (de Nederlandstalige omschrijving indien de StepCollectie wordt gebruikt bij het genereren van de Nederlandstalige bronpagina's, de Engelstalige omschrijving indien de StepCollectie wordt gebruikt bij het genereren van de Engelstalige bronpagina's, enz ... Elk omschrijvingsveld kan maximum |
Tabel 14: Velden in een stepcollectie
2 verborgen velden
Elke stepcollectie wordt weggeschreven in een standaard .xml-formaat wat maakt dat elke stepcollectie ook kan worden bekeken met standaard xml-browser-programma's.
Indien een stepcollectie wordt bekeken met een programma buiten StepCollect om, dan zal worden gezien dat nog twee verborgen velden aanwezig zijn op elk record van een stepcollectie.
|
Veld |
Verplicht? |
Type |
Omschrijving |
|---|---|---|---|
|
_cnr
|
Ja |
Geheel getal |
Bij het bewaren van elk record wordt een berekening uitgevoerd met de inhoud van alle velden in tabel 14. Deze berekening zal een andere waarde opleveren zodra minstens 1 karakters in één van de velden veranderd. Door deze waarde per record te bewaren kan StepCollect detecteren of de stepcollectie veranderd is geweest buiten het StepCollect programma om. |
|
_vnr |
Ja |
Geheel getal |
Elk record van een stepcollectie zal een versienummer bevatten zodanig dat StepCollect desgewenst de nodige acties kan ondernemen om de stepcollectie op te graden naar de huidige versie. |
Tabel 15: Verborgen velden in een stepcollectie
Gebruik van de velden
De voorgestelde doelen van de velden in een stepcollectie zijn slechts voorstellen en meer bedoeld om een aantal velden in een aantal verschillende types aan te bieden, dan om de gebruiker te dwingen een bepaalde kolom te gebruiken voor een bepaald doeleinde.
Zo heeft elk record een twee datum-velden, twee numerieke velden, een valuta-veld en verschillende tekstvelden (waarvan één speciaal bedoeld als veld waarin een afbeelding kan worden ingevoerd).
Met uitzondering van het code-veld is de gebruiker volledig vrij om te beslissen of een bepaalde kolom zal worden gebruikt voor die bepaalde stepcollectie, en, indien de kolom wordt gebruikt, wat de betekenis is van de waarde in de kolom.
De omschrijvingsvelden in de 8 talen
Zoals in latere hoofdstukken duidelijk zal worden zijn de 8 omschrijvingsvelden aanwezig met het doel om een om- of beschrijving te kunnen ingeven van het record dat wordt ingevoerd.
Indien de stepcollectie zal worden gebruikt om webpagina's aan te maken in verschillende talen, dan zullen deze omschrijvingsvelden kunnen worden gebruikt zoals bedoeld. De correcte omschrijving zal op de webpagina in de correcte taal worden getoond.
Indien de stepcollectie zal worden gebruikt om webpagina's in slechts één of twee talen aan te maken, dan kunnen deze 8 velden perfect worden gebruikt als extra tekstvelden ter omschrijving van het ingevoerde record.
Starten van het StepCollect programma.
Het StepCollect programma is tijdens de installatie van Sitestepper in dezelfde folder geïnstalleerd als alle andere programma's29.
Het programma dient te worden gestart vanuit een actief Sitestepperproject. Het StepGen-programma bevat dan ook via een menu-optie op het StepCollect-programma te starten: 'Project – Editeer stepcollectie...'. De sneltoets 'Ctrl-F12' is toegewezen aan deze menu-optie. Ook is de menu-optie 'Editeer stepcollectie...' aanwezig in het popup-menu (het zogenoemde kontekstmenu) dat wordt getoond wanneer men rechts-klikt op de projectboom.
Indien het popup- of kontekstmenu wordt gestart door rechts te klikken op een bronpagina van de StepCollectie (dus een pagina waarin de definitie staat van de tekst die moet worden herhaald voor elk aanwezig record in de stepcollectie), dan zal de naam van op te starten stepcollectie achter de tekst 'Editeer stepcollectie' worden getoond.
StepCollect dient gestart te worden vanuit een actief project
De reden dat een Sitestepperproject actief moet zijn, is dat vanuit dit programma afbeeldingen kunnen worden geïmporteerd (net zoals beschreven in het hoofdstuk: 'Werken met afbeeldingen').
Het StepCollect-programma moet dan ook kunnen terugvinden:
- Waar de afbeeldingen dienen bewaard te worden (in welke projectfolder).
- Welke waardes de verschillende galerijen hebben ontvangen (de kwaliteit van de te bewaren afbeelding, de breedte en/of hoogte van de afbeeldingen, in hoeveel formaten de afbeeldingen dienen geïmporteerd te worden en of er een copyright-tekst op de afbeeldingen dient geplaatst te worden).
Opmerking wat betreft de afbeeldingen
- Afbeeldingen geïmporteerd in een StepCollectie zullen dus op compleet dezelfde manier worden geïmporteerd in het actieve project als afbeeldingen die op 'gewone' webpagina's worden getoond.
- Dit houdt ook in dat afbeeldingen die via een StepCollectie zullen worden geïmporteerd, ook 'stand-alone' (dus buiten de StepCollectie om) kunnen worden gebruikt op de rest van de website.
- En dit houdt dus ook in dat afbeeldingen die reeds op andere pagina's van de website of in andere StepCollecties van het project, werden gebruikt, ook kunnen worden geselecteerd (en dus kunnen worden hergebruikt).
Het hoofdscherm van het StepCollect-programma
Indien het StepCollect-programma wordt gestart zonder dat een bronpagina voor StepCollect actief is, dan wordt StepCollect opgestart zonder actieve StepCollectie.
Wordt het StepCollect-programma gestart indien wel een bronpagina voor StepCollect actief is, dan wordt de desbetreffende stepcollectie automatisch ingeladen (zie het hoofdstuk: 'Schema punt 2 – de bronpagina van de stepcollectie' voor een volledige beschrijving van hoe dient te worden aangeduid welke stepcollectie zal worden gebruikt.
Spreadsheet-modus of kaart-modus
Sitestepper biedt twee modes aan waarin de records kunnen worden ingegeven.
- De spreadsheet-modus (ook wel tabel-modus
genoemd): de records worden ingevoerd als in een
spreadsheetprogramma. Eén record zal worden ingevoerd in één
rij en alle velden zullen naast elkaar in verschillende kolommen
worden getoond en kunnen worden ingegeven.
Verschillende records zijn zichtbaar op het scherm, maar om bepaalde kolommen te kunnen invoeren dient de horizontale schuifbalk te worden gebruikt. - De kaart-modus: de records worden ingevoerd als vroeger in de 'fichebakken'. Slechts één record is zichtbaar, maar de velden worden zeer overzichtelijk onder elkaar gepresenteerd om te worden ingegeven.
In voorgaande afbeelding wordt dezelfde stepcollectie ('star-trek') ingegeven in spreadsheet-modus (de bovenste 1/3 van de afbeelding), en hetzelfde record in kaart-modus (de onderste 2/3 van de afbeelding).
Kiezen voor spreadsheet-modus of kaart-modus
De gebruiker kan zelf kiezen welke modus hij wenst te gebruiken door op één van de twee tabbladen te klikken:
- als Tabel
- als Kaart
Als alternatieve methode kan de menu-optie: 'Beeld – Van kaart naar tabel en terug' wordt gekozen om de 'andere' modus actief te maken. De sneltoets F11 is toegewezen aan deze actie.
StepCollect houdt per stepcollectie bij welke mode actief was bij het afsluiten (of bewaren) van de stepcollectie). De volgende maal dat de stepcollectie wordt geladen, zal StepCollect automatisch de bewaarde modus selecteren.
Bewaren van een stepcollectie
Elke stepcollectie zal automatisch worden bewaard indien het StepCollect-programma wordt afgesloten of indien een andere stepcollectie wordt geopend.
Een stepcollectie wordt, net zoals spreadsheets, helemaal ingelezen in het geheugen van de pc. Net zoals bij spreadsheets is het dan ook ten stelligste aangeraden de pc niet af te zetten zolang het stepcollect-programma niet is afgesloten30.
Een stepcollectie kan tussentijds worden bewaard door de menu-optie: 'Bestand – Bewaar collectie' (or door het gebruik van de sneltoets Ctrl-S).
Opmerking
- StepCollect zal, telkens een stepcollectie wordt bewaard (automatisch bij het beëindigen van StepCollect, bij het laden van een nieuwe stepcollectie of door het uitvoeren van de 'Bewaar collectie' menu-optie), de reeds bestaande stepcollectie hernoemen naar eenzelfde naam maar met een numerieke extensie. De eerste back-up zal de extensie .000 krijgen, de tweede back-up de extensie .001, de derde back-up de extensie .002, enzovoort ...
Een nieuwe stepcollectie aanmaken
Een nieuwe stepcollectie kan worden aangemaakt door het kiezen van de menu-optie: 'Bestand – Nieuw' (of door het gebruik van de sneltoets Ctrl-N).
Een vraag zal worden gesteld om de nieuwe collectie een naam te geven:
Geef een nieuwe (unieke) naam in waaronder de stepcollectie dient bewaard te worden, en druk 'Ok'.
Vermits de stepcollectie als bestand zal worden bewaard met de naam die hier wordt ingevoerd, dient hier een naam te worden ingevoerd die zich houdt aan de regels qua naamgeving van alle andere Windows-bestanden.
De naam moet bestaan uit:
- alfabetische karakters
- cijfers
- en speciale tekens: ! @ # $ % & ( ) - _ [ ]
- spaties
Opmerkingen
- StepCollect zal (in de huidige versie) niet controleren of de ingevoerde naam voldoet aan de regels van een Windows-bestandsnaam, maar er zal wel een Windows-foutmelding worden getoond als de stepcollectie niet kan worden aangemaakt.
- Windows laat ook de accolade-karakters '' toe in een bestandsnaam. StepCollect zal dit ook toelaten, maar het is aan te raden deze niet te gebruiken, vermits de accolades binnen de Sitestepper-omgeving een speciale betekenis hebben (als start en einde van de stepvars).
StepCollect zal:
- de nieuwe stepcollectie aanmaken
- de nieuwe stepcollectie automatisch laden
- standaard de spreadsheet-modus selecteren

De stepcollect-hoofding zal de naam van de nieuwe stepcollectie tonen.
Een stepcollectie openen
Een stepcollectie kan worden geopend door het uitvoeren van de menu-optie: 'Bestand – Open collectie' (of de sneltoets Ctrl-O).
Een lijst van aanwezige stepcollecties zal worden getoond.
Door één van de aanwezige stepcollecties te selecteren en 'Open' te kiezen, wordt de geselecteerde stepcollectie ingeladen. Was nog een stepcollectie aanwezig in het geheugen, dan wordt deze eerst bewaard vooraleer de nieuw geselecteerde te laden.
Versies van het StepCollect-bestandsformaat
Zoals te zien is in afbeelding 140 hierboven, kan het zijn dat dezelfde StepCollect verschillende malen lijkt voor te komen in de lijst. In de getoonde afbeelding is dit het geval met de stepcollectie met de naam 'Evenementenkalender'.
Zo is de stepcollectie 'Evenementenkalender' aanwezig als:
- StepCollect-Evenementenkalender.xml
- StepCollectv2-Evenementenkalender.xml
- StepCollectv3-Evenementenkalender.xml
StepCollect zal automatisch, bij het aanmaken van een nieuwe stepcollectie een voorvoegsel en een extensie toevoegen aan de ingevoerde naam (om zodoende de bestandsnaam te creëren waaronder de stepcollectie zal worden weggeschreven).
Het voorvoegsel is afhankelijk van het huidige bestandsformaat (in versie 1.7.x is StepCollect reeds aan het derde bestandsformaat toe en dus wordt het voorvoegsel 'StepCollectv3-' gebruikt.
Als extensie zal .xml worden gebruikt, vermits elke stepcollectie wordt weggeschreven in het xml-formaat.
Welke van de getoonde stepcollectie ook wordt gekozen, steeds zal de versie worden ingeladen die overeenkomst met het huidige bestandsformaat. StepCollect zal automatisch de nodige conversies uitvoeren, maar deze in de huidige versie van de software nog in dezelfde folder laten staan.
Heropenen van een stepcollectie
StepCollect houdt een historiek bij van de laatst geopende stepcollecties.
Door één van de stepcollecties uit de historiek te selecteren, wordt de geselecteerde stepcollectie geopend (het equivalent van het kiezen van 'Besand – Open collectie'.
De historiek kan op twee verschillende manieren worden getoond.
Historiek in het bestands-menu
De historiek van de laatste geopende stepcollecties is aanwezig als menu-opties in de menu-optie: 'Bestand'.
Historiek via de Heropen-knop
Een tweede manier om de historiek van de laatst geopende stepcollecties te tonen is via de knop 'Heropen...' in de knoppenbalk.
Invoeren van gegevens in een stepcollectie
Invoeren van een record in spreadsheet-modus
Alhoewel het invoeren van de verschillende records van een stepcollectie in eerste instantie gebeurt in spreadsheet-modus, toch is er een zeer belangrijk verschil met het invoeren van gegevens in een spreadsheet-programma.
Bij het aanmaken van een nieuwe spreadsheet zullen automatisch een vast aantal rijen en een vast aantal kolommen worden aangemaakt.
Deze rijen en kolommen worden op het scherm getoond, ook al bevatten ze geen gegevens.
StepCollect zal echter niet automatisch lege records aanmaken, maar, net zoals andere databaseprogramma's (zoals Access, Paradox en FileMaker) wachten tot de gebruiker expliciet records wenst toe te voegen.
In tegenstelling tot een spreadsheet, waar de gebruiker op eender welke rij de gegevens kan invoeren, zal StepCollect de records één per één toevoegen op het moment dat de gebruiker hierom verzoekt door het aanklikken van de '+'-knop in de knoppenbalk.
Een nieuw record zal worden toegevoegd aan de stepcollectie, klaar om te worden ingevuld met gegevens.
Omdat de stepcollectie momenteel leeg is (want deze is net aangemaakt), zal het nieuwe record bovenaan de (lege) lijst worden aangemaakt.
Wordt de '+'-knop aangeklikt in een stepcollectie met reeds aanwezige records, dan wordt het nieuwe record initieel aangemaakt op de dezelfde rij op het scherm van het huidige record (dat plaats zal maken voor het nieuwe record door één positie naar beneden te schuiven.
De '+'-knop werd aangeklikt toen de record met als code 'OS.1' geselecteerd was.
Het nieuwe record kan worden toegevoegd op de fysische schermplaats van het eerder geselecteerde record, dat positioneel één plaats naar onder zal worden verschoven.
In tegenstelling dat verschillende databaseprogramma's (waar nieuwe records vaak onderaan worden bijgevoegd), is dit een zeer gemakkelijke handige manier om reeds eerder ingevoerde records op het scherm te tonen bij het invoeren van een nieuw record (om bijvoorbeeld exact dezelfde titel te gebruiken, of dezelfde datum ...).
Invoeren van een record in kaart-modus
Als de kaart-modus actief is zal het aanklikken van de '+'-toets ook een nieuw record invoeren, en dit nieuwe record tonen in een lege kaart.
Invoeren van de omschrijvingsvelden
De 8 om- of beschrijvingsvelden zijn speciaal qua mogelijkheid tot invoeren van de waarde.
Terwijl alle andere velden worden ingegeven in een invoerveld dat slechts één lijn laat zien (zoals gebruikelijk in de meeste invoervelden in de Windows-omgeving), zullen de omschrijvingsvelden kunnen worden ingevoerd in een tekstveld met meerdere lijnen.
Zodra wordt geklikt in één van de omschrijvingsvelden (en dit geldt zowel in spreadsheet-modus als in kaart-modus), dan wordt het veld vergroot naar een memo-achtig formaat.
Normale editeeracties (zoals kopiëren, knoppen en plakken) kunnen worden ingevoerd.
In tegenstelling tot de andere velden (waar de 'Enter'- of 'Return'-toets de invoer van het veld zal beëindigen, zal in het omschrijvingsveld de 'Enter'- of 'Return'-toets een nieuwe lijn beginnen.
De waarde wordt bewaard door op de 'OK' knop te klikken.
De nieuwe waarde wordt niet bewaard, indien de 'Cancel'-knop wordt aangeklikt.
Opmerking
- Het veld kan breder of smaller worden gemaakt door met de muis de onderkant rechts te verslepen.
Bewaren van een record
Een record wordt bewaard zodra het ingevoerde record wordt verlaten.
Men kan het record verlaten door:
- In spreadsheet-modus op één van de andere records te klikken.
- In spreadsheet-modus de navigatie-toetsen op het toetsenbord te gebruiken om van geselecteerd record te veranderen (de cursor op en cursor down toets selecteren automatisch het vorige en volgende record, de Page Up en Page Down toetsen tonen de vorige of volgende 10 records, en de home en end toetsen selecteren het eerste of laatste record in de stepcollectie.
- In kaart-modus de horizontale schuifbalk te gebruiken vermits dit hetzelfde effect heeft als de cursor op en cursor down toets in spreadsheet-modus (het selecteren van de vorige of het volgende record van de stepcollectie).
- De navigatie-knoppen te gebruiken die worden getoond in de knoppenbalk.
-
Van links naar rechts: het eerste record, het vorige record, het volgende record, en het laatste record.
Opmerkingen
- Alle waardes in het code-veld van elk record moeten uniek zijn in de hele collectie. Indien een waarde wordt ingevoerd in het code-veld die reeds voorkomt in de stepcollectie dan zal een foutmelding worden getoond.
-
Er werd in afbeelding 139 geprobeerd in record toe te voegen met de code 'DS9.1'. Vermits deze code reeds bestaat en alle codes uniek moeten zijn, wordt een foutmelding getoond. - Klik op 'Ok' om de foutmelding te verwijderen van het scherm, en pas de waarde in het code-veld aan zodanig dat deze uniek wordt over heel de stepcollectie heen.
- Zowel het code veld als het titel veld moeten ingevuld zijn.
- Indien geprobeerd wordt een record te bewaren met een leeg code- of titel-veld, dan zal eveneens een foutmelding worden getoond.
-
Klik op 'Ok' om de foutmelding te verwijderen van het scherm, en vul een waarde in alvorens het record te bewaren.
Verwijderen van een record
Aanpassingen aan een bestaand record of het invoeren van een nieuw record kunnen worden ongedaan gemaakt alvorens de record te bewaren door:
- het indrukken van de 'Esc'-toets
- het kiezen van 'Annuleer'-knop in de knoppenbalk
Opgelet
- De invoeren van het nieuwe of aangepaste record zal onmiddellijk worden beëindigd zonder confirmatie.
Het verwijderen van reeds bestaande record dient te worden uitgevoerd door het kiezen van de '-'-knop in de navigatiebalk.
Opgelet
- Het verwijderen van records zal in de huidige versie van de software worden uitgevoerd zonder bijkomende confirmatie.
De navigatiebalk
Alle knoppen van de navigatiebalk zijn besproken in voorgaande hoofdstukjes.
Er dient alleen nog vermeld te worden dat de knoppen actief zullen zijn in de desbetreffende actie kan worden uitgevoerd, en niet actief indien de desbetreffende actie niet kan worden uitgevoerd.
Zo zal, bijvoorbeeld, de 'verwijder'-knop niet actief zijn in een lege stepcollectie, en zal de 'annuleer'-knop niet actief zijn indien geen nieuwe gegevens worden ingevoerd.
De knoppen in de navigatiebalk werken zowel in spreadsheet-modus als in kaart-modus.
Kolombreedtes in spreadsheet-modus
Manueel de kolombreedte veranderen
Elke kolom in spreadsheet-modus kan manueel worden verbreed of versmald door de muispointer te plaatsen op de scheiding op de titellijn van de kolom waarvan de breedte dient te worden aangepast, en de kolom daar onmiddellijk rechts van.
De cursor zal worden veranderd in een kruisteken met pijlen links en rechs op de horizontale as.

Door de links muistoets ingedrukt te houden en vervolgens de muis links
en rechts te bewegen, kan de kolombreedte van de kolom links van de
muispointer worden verbreed of versmald.
Zodra de muis wordt losgelaten, wordt de nieuwe kolombreedte ingesteld.
Automatisch de optimale kolombreedte gebruiken – voor één lolom
StepCollect bevat een zeer handige manier om de breedte van een kolom aan te passen aan de langste waarde die zich ergens in de kolom bevindt.
Net zoals in het voorgaande hoofdstukje over het manueel aanpassen van de kolombreedte, dient de muispointer te worden geplaatst op de scheiding op de titellijn van de kolom waarvan de breedte dient te worden aangepast.
Indien vervolgens wordt dubbel-geklikt, zal StepCollect automatisch alle waardes in de volledige kolom onderzoeken en de breedte van de kolom zo instellen dat de langste waarde kan worden getoond.
Automatisch de optimale kolombreedtes gebruiken voor alle kolommen
Door middel van de menu-optie: 'Editeer – Zet kolombreedte' kan dezelfde actie worden uitgevoerd als het optimaal instellen van een kolom, maar dan automatisch en voor alle velden van de stepcollectie.
Met andere woorden: na het uitvoeren van deze actie zullen alle kolommen in de spreadsheet-modus even breed zijn als de langste waarde in de desbetreffende kolom.
Tip
- Bij het aanmaken van een nieuwe stepcollectie worden de breedtes van alle kolommen ingesteld op vaste (voor-ingestelde) waardes afhankelijk van de maximum aantal karakters dat kan worden ingevoerd in de kolom.
- Deze voor-ingestelde waardes maken de meeste kolommen heel breed wat maakt dat slechts enkele kolommen zichtbaar zijn op het scherm.
- Indien onmiddellijk de optie 'Editeer – Zet kolombreedte' wordt uitgevoerd, zullen de kolommen de breedte krijgen van de kolomtitel (vermits voor de rest nog geen waardes aanwezig zijn in de stepcollectie), wat betekent dat veel meer kolommen zichtbaar zullen op het scherm.
- De volgende afbeelding toont het scherm onmiddellijk na het aanmaken van een nieuwe stepcollectie en onmiddellijk na het uitvoeren van 'Edit – Zet kolombreedte'.
-
Zodra een aantal gegevens zijn ingevoerd in één of meerdere records, kan dezelfde optie opnieuw worden uitgevoerd om een iets meer realistisch kader te bekomen om verder gegevens in te geven (zoals te zien in afbeelding 138.op pagina 217).
Tip
- De kolombreedtes worden per stepcollectie bewaard zodanig dat elke stepcollectie zijn eigen (optimale of toch door de gebruiker zelf ingestelde) ingavescherm toont tijdens het invoeren van de gegevens.
Kolommen verslepen in spreadsheet-modus
Elke stepcollectie bevat 19 verschillende kolommen waarin waardes kunnen worden ingevoerd.
Per stepcollectie zal (in de meeste gevallen) echter slechts een aantal van deze kolommen werkelijk worden ingevuld.
Zo zullen zeker niet alle omschrijvingsvelden (die aanwezig zijn in elk van de 8 talen die ook kunnen gebruikt worden in een Sitestepper-project) worden ingevuld, maar kan het ook perfect voorkomen dat het valuta-veld niet gebruikt wordt, maar, bijvoorbeeld, dat het extra geheel getal of het extra datumveld, wel een zeer belangrijke waarde vormen.
Als voorbeeld kan hier worden gegeven een stepcollectie waarin twee datums per record dienen ingevoerd te worden (een van-datum en een tot-datum), teneinde een periode te kunnen omschrijven. Bij voorkeur zouden beide datumvelden naast elkaar op het scherm gepresenteerd moeten worden.
StepCollect laat dan ook toe om de volgorde van alle kolommen zelf te bepalen. De gebruiker kan één of meerdere kolommen van plaats verwisselen door de volgende handelingen uit te voeren:
- Plaats de muispointer op de titel van de kolom die dient te worden versleept.
- Hou de muispointer ingedrukt en beweeg de muis naar links of naar rechts.
- De kolomtitel zal de muis volgen tot de muis wordt losgelaten.
- Indien de muispointer zich, bij het
loslaten, in de buurt van twee andere kolommen bevindt, dan zal de
kolom waarop eerst werd geklikt, tussen beide kolommen worden
geplaatst.
Twee groene pijltjes zullen de plaats aanduiden waarheen de kolom dient versleept te worden.
In afbeelding 137 wordt de kolom 'extradate' gesleept tot tussen de kolom 'date' en 'year'. De groene pijl laat zien waar de kolom zal worden geplaatst indien de muispointer wordt losgelaten.
Na het loslaten van de muispointer verplaatst de kolom 'extradate' zich tot naar de gekozen plaats.
Om de ingave van dergelijke stepcollecties te vergemakkelijken, laat StepCollect toe om de kolommen van plaats te verwisselen door de titel te slepen.
Tip
- De kolomposities worden (net als de kolombreedtes) per stepcollectie bewaard zodanig dat elke stepcollectie zijn eigen, door de gebruiker zelf gekozen, kolomvolgorde toont tijdens het invoeren van de gegevens.
Kolomtitels veranderen
Vermits alle stepcollecties, allicht, een verschillende inhoud zullen weergeven (of een verschillende verzameling zullen bevatten), is het mogelijk de standaard titels van elke stepcollectie te wijzigen.
De titel van elke kolom kan worden veranderd door de volgende handeling uit te voeren.
Belangrijke opmerking
- In de huidige versie werkt deze optie enkel in spreadsheet-modus en indien tenminste één record aanwezig is in de stepcollectie. Voer deze optie dan ook pas uit indien u minstens 1 gegeven hebt ingevoerd.
En dan nu de stappen:
- Klik in de kolom van dewelke de kolomtitel dewelke dient veranderd te worden.
- Kies de menu-optie: 'Editeer – Hernoemkolom', of gebruik de sneltoets Ctrl-F2.
- Voer een nieuwe naam in, en druk op 'Ok'.
-
De kolomnaam zal veranderd zijn in de zonet ingetypte naam.
Tip
- De zelf ingevoerd kolomnamen worden per stepcollectie bewaard zodanig dat elke stepcollectie zijn eigen set aan kolommen toont tijdens het invoeren van de gegevens, en dit zowel in spreadsheet als in kaartmodus.
Schema punt 2: Creëer de bronpagina
Stepcollection-stuurgedeelte
Het stuurgedeelte ven een stepcollection-pagina dient altijd omsloten te zijn door twee html-commentaarlijnen. Als volgt:
<!--StepCollect start collection="naam-collectie" type="auto"HTMLcode 28: StepCollect stuurlijnen
id="id-collectie" linkedkw="keyword"--> ... ter herhalen lijnen ... <!--StepCollect end -->
Het stuurgedeelte wordt gestart met een html-commentaarlijn die start met '<!--StepCollect start ' en zal worden afgesloten met een html-commentaarlijn die start met <!--StepCollect end '.
Alle lijnen tussen deze beide lijnen worden x-keren herhaald (in de gegenereerde Steppagina), waarbij x variabel is en afhankelijk van het gekozen type.
Opmerking: De startlijn in voorgaande voorbeeld is over twee lijnen in de documentatie geplaatst. In de bronteksten dient de startlijn één enkele lijn te zijn.
Parameters van de StepCollect-startlijn
|
Parameter |
|
Uitleg |
|---|---|---|
|
collection= |
[verplicht] |
De bestandsnaam van de collectie zoals deze
werd gekozen in het StepCollectprogramma (de feitelijke
bestandsnaam zal de prefix 'StepCollectv<versie>-' en de
extensie '.xml' bevatten, maar deze vaste waardes dienen hier
niet vermeld te worden. |
|
type= |
[optioneel] |
Hier kan worden gekozen uit:
|
|
id= |
[verplicht] |
Hier dient een unieke naam te worden gekozen per collectie in het project. Na het genereren van de (één of meerdere) pagina's, zullen in het huidig project automatisch vervangvariabelen beschikbaar zijn die allen beginnen met de ingevoerde (unieke) naam. |
|
linkedkw= |
[optioneel] |
Hier kan optioneel een bestaand keyword van een pagina uit het project worden ingevoerd. Indien aanwezig dan zullen vervangvariabelen worden aangemaakt die beginnen met '{ stepcollect-linked'. Op deze manier kan een link worden gelegdÿ tussen verschillende pagina's die gegenereerd worden doorÿ StepCollect. ÿ | ÿ
| ÿ breakafter= | ÿ ÿ [optioneel] ÿ | ÿ ÿ Deze parameter zal een nieuwe stepvar genaamdÿ "Stepcollection-breaktag" opvullen met: ÿ
Het resultaat is dat, indien <div>-elementenÿ worden gebruikt om één record te omlijsten, enÿ deze <div>-elementen krijgen een style-waarde vanÿ float:left, dat elk-zoveelste record op een nieuwe lijn begintÿ (met andere woorden: we kunnen een grid-effect bekomen in html). ÿ | ÿ
Lijst van stepvars aangemaakt door StepCollect
ÿ ÿLijst van stepvars aanwezig tijdens hetÿ genereren van de bronpagina's
ÿDe volgende stepvars kunnen worden gebruikt (enÿ bevatten enkel een waarde) in het StepCollection-stuurgedeelte enÿ dienen om het gedeelte dat x-aantal keren zal herhaald worden perÿ gelezen record andere waardes te geven.
ÿMet andere woorden: onderstaande StepVars zullen,ÿ telkens een ander record van de StepCollectie op de gegenereerdeÿ pagina wordt geplaatst, een andere waarde krijgen – de waardeÿ van het huidige record.
ÿ| ÿ Naam van de stepvar ÿ | ÿ ÿ Omschrijving ÿ | ÿ
|---|---|
| ÿ {stepcollect-recnr} |
Opeenvolgend nummer, startende vanaf 1. Kan worden gebruikt om de gegenereerde records of gegenereerde blokken te nummeren. Dit nummer wordt herzet telkens een nieuwe pagina wordt gegenereerd en kan derhalve worden gebruikt om de records per pagina te nummeren vanaf 1. |
|
{stepcollect-index} |
Opeenvolgend nummer, startende vanaf 1. Dit nummer loopt door over heel de collectie en zal de positie aanduiden binnen de StepCollectie, niet binnen de gegenereerde pagina. |
|
Bij type-all (zie tabel 16) zijn de en gelijk vermits hier alle records van de stepcollectie aanwezig zijn op één pagina. Bij de andere types (waar meerdere pagina's worden gegenereerd, zal een nummering per pagina mogelijk maken, terwijl steeds de nummering ten opzichte van de hele collectie weergeeft. |
|
|
{stepcollect-code} |
De waarde uit het code-veld van de stepcollectie. |
|
{stepcollect-title} |
De waarde uit het title-veld van de stepcollectie. |
|
{stepcollect-subtitle} |
De waarde uit het subtitle-veld van de stepcollectie. |
|
{stepcollect-date} |
De waarde uit het date-veld van de stepcollectie. |
|
{stepcollect-year} |
De waarde uit het year-veld van de stepcollectie. |
|
{stepcollect-price} |
De waarde uit het price-veld van de stepcollectie. |
|
{stepcollect-picture} |
De integrale waarde uit het picture-veld van de stepcollectie. |
|
{stepcollect-picturewidth} |
Bevat de breedte van de afbeelding indien een afbeelding aanwezig is in het stepcollectie-record én deze bestaat in het Sitestepper-project. Bevat 0 indien geen afbeelding aanwezig is. |
|
{stepcollect-pictureheight} |
Bevat de hoogte van de afbeelding indien een afbeelding aanwezig is in het stepcollectie-record én deze bestaat in het Sitestepper-project. Bevat 0 indien geen afbeelding aanwezig is. |
|
{stepcollect-picturedisplay} |
Indien de afbeelding in het project bestaat, dan wordt hier één van de twee volgende woorden ingevuld:
Door deze stepvar te gebruiken in de css-parameter display, kan worden bekomen dat een volledig <IMG wel of niet op de webpagina wordt getoond (indien de afbeelding wel of niet bestaat). |
|
{stepcollect-picturename} |
Bevat enkel het naamgedeelte van de waarde uit het picture-veld van de stepcollectie. Het naamgedeelte is de waarde zonder folder (of en zonder extensie. |
|
{stepcollect-picturefilename} |
Bevat zowel het naamgedeelte als de extensie uit de waarde uit het picture-veld van de stepcollectie. M.a.w. de volledige waarde zonder folder of {#ImageRoot}. |
|
{stepcollect-extratext} |
De waarde uit het extratext-veld van de stepcollectie. |
|
{stepcollect-extradate} |
De waarde uit het extradate-veld van de stepcollectie. |
|
{stepcollect-extraint} |
De waarde uit het extraint-veld van de stepcollectie. |
|
{stepcollect-stepkeyword} |
Het door StepCollectGen gegenereerde aangemaakt keyword voor de huidige pagina. |
|
{stepcollect-breaktag} |
Eén van de volgende twee waarden:
|
|
Omschrijvingvelden |
|
|
{stepcollect-descr} |
De waarde van één van de andere 8 descr-kolommen. Afhankelijk van de taal van de bronpagina wordt de waarde uit één van de 8 andere (taalgebonden) descr-velden genomen en in geplaatst (om zodoende één broncode mogelijk te maken over alle talen heen). |
|
{stepcollect-descrEN} |
De expliciete waarde van het descrEN-veld van de stepcollectie. |
|
{stepcollect-descrNL} |
De expliciete waarde van het descrNL-veld van de stepcollectie. |
|
{stepcollect-descrFR} |
De expliciete waarde van het descrFR-veld van de stepcollectie. |
|
{stepcollect-descrGE} |
De expliciete waarde van het descrDE-veld van de stepcollectie. Opmerking: de is een overblijfsel van een foutief gekozen code voor Duitstalige pagina's. De DE-versie is diegene die dient gebruikt te worden vermits dit de correcte tweeletterige ISO-afkorting voor Duitsland. |
|
{stepcollect-descrIT} |
De expliciete waarde van het descrIT-veld van de stepcollectie. |
|
{stepcollect-descrES} |
De expliciete waarde van het descrES-veld van de stepcollectie. |
|
{stepcollect-descrPT} |
De expliciete waarde van het descrPT-veld van de stepcollectie. |
|
{stepcollect-descrJP} |
De expliciete waarde van het descrJP-veld van de stepcollectie. |
Stepvars indien de 'linkedkw' parameter aanwezig is:
De volgende stepvars zullen enkel van nut indien de linkedkw'-parameter aanwezig is op de startlijn van de StepCollectie. Ze zijn bedoeld om steplinken te genereren die kunnen verwijzen naar verschillende pagina's die dezelfde stepcollectie gebruiken.
Alle drie de stepvars zullen een waarde krijgen gelijk aan het Sitestepper keyword opgegeven op de parameterlijn, maar aangevuld met de correcte syntax voor één van de drie types.
|
naam van de stepvar15 |
Omschrijving |
|---|---|
|
{stepcollect-linkedautomatic} |
Een Sitestepper keyword gelijk aan het opgegeven keyword achter de linkedpw-parameter, aangevuld met de correcte suffix die wordt gebruikt door StepCollect bij het aanmaken van bronpagina's met een Stepcollectie van het type gelijk aan 'automatic'. |
|
{stepcollect-linkedcode1} |
Een Sitestepper keyword gelijk aan het opgegeven keyword achter de linkedpw-parameter, aangevuld met de correcte suffix die wordt gebruikt door StepCollect bij het aanmaken van bronpagina's met een Stepcollectie van het type gelijk aan 'code1'. |
|
{stepcollect-linkedcodedot} |
Een Sitestepper keyword gelijk aan het opgegeven keyword achter de linkedpw-parameter, aangevuld met de correcte suffix die wordt gebruikt door StepCollect bij het aanmaken van bronpagina's met een Stepcollectie van het type gelijk aan 'codedot'. |
StepVars aanwezig in het project na het genereren van de StepCollect-pagina's
De volgende stepvars worden bewaard tussen verschillende sessies en worden derhalve actief (ze krijgen en behouden een waarde) zodra ten minste éénmaal de actie 'Genereer Stepcollectpagina's' uitgevoerd is.
|
naam van de stepvar |
omschrijving |
|---|---|
|
unieke-id_Count |
=totaal aantal gevonden gegevens in de stepcollectie |
|
Per gegenereerde
pagina: |
=aantal gegevens aanwezig op deze pagina |
Deze stepvars (step-variabelen) zullen vooral worden gebruikt om op de, door StepCollectGen, gegenereerde pagina's het aantal aanwezige records in de stepcollectie of het aantal aanwezige records per gegenereerde pagina te kunnen tonen.
Sitestepper voorziet deze stepvars vermits deze waarde immers veranderd zodra een aanpassing wordt uitgevoerd aan een StepCollectie. Het alternatief zou zijn dat de gebruiker zelf deze waardes moet veranderen.
Schema punt 3: Start StepCollectGen
Zodra gegevens zijn ingevoerd in de stepcollectie én de bronpagina is aangemaakt die als basis zal dienen voor de bronpagina's die moeten worden gegenereerd, dient StepCollectGen te worden opgeroepen om de pagina's effectief te genereren.
Stappen om de StepCollectiepagina's te genereren
- Klik in de projectboom de stuur-bronpagina aan die het Stepcollection-stuurgedeelte bevat.
- Kies de menu-optie: 'Genereer – Genereer StepCollectpagina's'.
-
De StepCollectGen-optie zal worden opgestart en het volgende scherm tonen. -
Kies 'Creëer'. De stepcollectie zal worden gelezen. - In de projectboom zullen één of meerdere pagina's (afhankelijk van de type-parameter op de StepCollect-stuurlijn) worden aangemaakt. Indien de pagina die wordt gegenereeerd reeds zou bestaan, dan wordt deze eerste verwijderd vooraleer de nieuwe pagina wordt gegenereerd.
Gegevens aanwezig in het StepCollectGen-scherm.
Zoals te zien in figuur 136 op pagina 210, toon het StepCollectGen-scherm de volgende informatie.
- De gevonden stepcollectie (in het voorveeld: star-trek 31).
- De naam van de bronpagina van de stuurpagina (in het voorbeeld: stepcollect voorbeeld per alfabet). Dit is de naam van de bronpagina die werd aangeklikt vooraleer de StepCollect-optie te starten.
- Het Sitestepper-keyword van de aangeklikte pagina.
-
Het totaal aantal records aanwezig in de StepCollectie.
Wordt de genereer StepCollectpagina's opgestart vanaf een bronpagina die geen stuurlijn bevat, dan zal het StepCollectGen-scherm er uitzien als volgt en dan zal de 'Creëer'-knop niet kunnen worden aangeklikt.
Schema punt 4: de gegenereerde bronpagina's
Zodra de acties uit punt 3 zijn uitgevoerd, zijn automatisch één of meerdere volwaardige bronpagina's aangemaakt in de Sitestepper-projectoom.
Deze bronpagina's zijn, vanaf dat moment, bronpagina's alsof ze manueel zouden zijn ingevoerd.
Ze zullen op exact dezelfde manier worden behandeld als andere (door de gebruiker ingevoerde) bronpagina's uit het project.
Om dit te kunnen uitvoeren heeft de StepCollectGen-module er voor gezorgd:
- dat de gegenereerde bronpagina's een unieke naam hebben
- dat elke gegenereerde bronpagina een uniek keyword heeft toegewezen gekregen
- dat elke gegenereerde bronpagina een skeleton heeft toegewezen gekregen
Een unieke naam voor elke gegenereerde bronpagina
StepCollectGen zal de naam van de te genereren bronpagina's bepalen als volgt:
- de naam van de bronpagina wordt genomen
- deze naam wordt aangevuld met één van de volgende suffixen:
- '_automatic': indien het type opgegeven op de StepCollect-stuurlijn gelijk was aan 'all'.
- '_<karakter>':
indien het type opgegeven op de StepCollect-stuurlijn gelijk was
aan 'code1', waarbij <karakter> zal worden vervangen het
eerste karakter van het code-veld.
Er zullen, m.a.w. evenveel bronpagina's worden gegenereerd als er unieke eerste karakters voorkomen in het codeveld van de de stepcollectie, waarbij alle records met hetzelfde eerste karaketer in het code-veld bij elkaar op een pagina worden geplaatst. - '_<code>':
indien het type opgegeven op de StepCollect-stuurlijn gelijk was
aan 'codedot', waarbij <code> wordt vervangen door alle tekst
van het code-veld tot vlak voor het eerste '.'-karakter in het
code-veld.
Er zullen m.a.w. evenveel bronpagina's worden gegenereerd als er unieke combinaties aanwezig zijn in het code-veld van de stepcollectie, waarbij enkel de waarde tot het eerste '.'-karakter wordt gebruikt.
Opmerking
- De gegeneerde bronpagina's zijn niet bedoeld om te worden geëditeerd vanuit StepGen. StepGen zal dit niet verhinderen maar vermits deze bronpagina's telkens opnieuw worden gegeneerd zodra de StepCollectGen-actie wordt uitgevoerd, zouden alle aangebrachte wijzigingen worden overschreven.
Een uniek keyword voor elke gegenereerdebronpagina
Dezelfde suffix die wordt gebruikt om unieke bronpagina's te genereren, wordt ook gebruikt om unieke keywords te genereren.
StepCollectGen zal de naan van deze keywords bepalen als volgt:
- het keyword van de bronpagina's
- aangevuld met dezelfde suffix als besproken in de voorgaande paragraaf ('Een unieke naam voor elke gegenereerde bronpagina).
Toegewezen skeleton aan de gegenereerde bronpagina
Sitestepper zal, bij het aanmaken van nieuwe bronpagina's, automatisch de skeleton van de bronpagina waaronder de nieuwe pagina wordt aangemaakt, overnemen als standaardwaarde.
Vermits de door StepCollectGen gegeneerde bronpagina's onder de stuurpagina worden aangemaakt, zal automatisch ook de skeleton toegewezen aan de stuurpagina worden gebruikt als skeleton voor de door StepCollectGen gegenereerde bronpagina's.
Voorbeeld gegenereerde pagina's
Zoals steeds, zal een voorbeeld veel duidelijk maken. De bij Sitestepper meegeleverde stepcollectie van Star-Trek-boeken zal worden gebruikt om bronpagina's te genereren voor de drie verschillende types.
<ROW code="" title="" subtitle="" active="TRUE" picture="" _cnr="874269206" _vnr="3"/>
|
Code |
Title |
SubTitle |
DescrNl |
Picture |
|---|---|---|---|---|
|
OS.1 |
Star Trek |
Invasion |
|
{#ImageRoot}\lec-st-001.jpg |
|
OS.2 |
Star Trek |
Adventures in Time and Space |
|
{#ImageRoot}\lec-st-002.jpg |
|
NG.1 |
Star Trek Next Generation |
First Contact |
|
{#ImageRoot}\lec-stng-001.jpg |
|
NG.2 |
Star Trek Next Generation |
IQ |
|
{#ImageRoot}\lec-stng-002.jpg |
|
NG.3 |
Star Trek Next Generation |
Imzadi |
|
{#ImageRoot}\lec-stng-007.jpg |
|
DS9.1 |
Star Trek Deep Space 9 |
Millenium |
|
{#ImageRoot}\lec-std9-001.jpg |
|
NF.1 |
Star Trek New Frontier |
|
De New Frontier serie (geschreven door Peter David) is een must voor alle Star Trek fans... |
{#$ImageRoot}\lec-stnf-001.jpg |
|
NF.2 |
Star Trek New Frontier |
|
|
{#ImageRoot}\lec-stnf-002.jpg |
|
NF.3 |
Star Trek New Frontier |
|
|
{#ImageRoot}\lec-stnf-003.jpg |
|
NF.4 |
Star Trek New Frontier |
|
|
{#ImageRoot}\lec-stnf-004.jpg |
|
NF.5 |
Star Trek New Frontier |
|
|
{#ImageRoot}\lec-stnf-005.jpg |
De stepcollectie omvat:
- 11 records
- 3 verschillende eerste karakters in het code veld
- 4 verschillende waardes van tekst voor het eerste '.'-karakter in het code-veld
Gegeneerde pagina bij type='all'.
Stuurlijn:
<!--StepCollect start collection="star-trek" id="startrek-overzicht"-->
HTMLcode 29: Stuurlijn met type='all'
Opmerking:
- De type-parameter is weggelaten, dus wordt automatisch 'all' genomen als waarde. M.a.w., bovenstaande lijn is hetzelfde als zou er type="all" aanwezig zijn op de lijn.
Na het uitvoeren van StepCollectGen zal één bronpagina zijn aangemaakt.
De suffix '-automatic' is gebruikt om een unieke naam te bekomen voor de gegenereerde bronpagina én om een uniek keyword te bekomen.
Gegenereerde pagina's bij type='cod1'.
Stuurlijn:
<!--StepCollect start collection="star-trek" type="code1" id="startrek"-->
HTMLcode 30: Stuurlijn met type='code1'
Na het uitvoeren van StepCollectGen zullen evenveel bronpagina's zijn aangemaakt als er unieke eerste karakters zijn in het code-veld van de stepcollectie.
Om unieke bronpagina's en keywords te bekomen is, per pagina, de letter toegevoegd als suffix. M.a.w., alle records met de 'D' als eerste karakter in het code-veld zullen aanwezig zijn in de pagina 'stepcollect voorbeeld per alfabet-'D', alle records met de 'N' als eerste karakter in het code-veld zullen aanwezig zijn in de pagina 'stepcollect voorbeeld per alfabet-'N', enzovoort ...
Gegenereerde pagina's bij type='codedot'.
Stuurlijn:
<!--StepCollect start collection="star-trek" type="codedot"
id="startrek-perreeks"-->
HTMLcode 31: Stuurlijn met type='codedot'
Na het uitvoeren van StepCollectGen zullen evenveel bronpagina's zijn aangemaakt als er unieke combinaties voorkomen van teksten uit het code-veld van de stepcollectie waarbij elke combinatie eindigt bij het eerste '.'-karakter.
Elke gevonden unieke combinatie zal worden toegevoegd als suffix om unieke bronpagina's en unieke keywords te bekomen.
Automatisch gegenereerde stepvars na het uitvoeren van bovenstaande acties
Zoals reeds aangehaald in StepVars aanwezig in het project na het genereren van de StepCollect-pagina's
op blz. 241, zullen automatisch, na elke StepCollectGen-actie
(waarbij één of meerdere bronpagina's worden
aangemaakt, stepvars worden aangemaakt dewelke dan kunnen worden
gebruikt binnen het project (net zoals elke andere stepvar) door
deze tussen of «-» in de
bronpagina's te plaatsen.
De volgende tabel geeft een overzicht van alle aangemaakte stepvars.
|
Naam van de StepVar |
Waarde |
Omschrijving |
|---|---|---|
collection="star-trek" id="startrek-overzicht"
|
||
startrek-overzicht_Count
|
11 |
Totaal aantal records aanwezig op deze (éne) gegenereerde pagina. |
startrek-overzicht_PageKwCount
|
1 |
Aantal gegenereerde pagina's. |
startrek-overzicht_PageKw_1
|
stepcollect_voorbeeld_automatic |
Keyword van de gegenereerde pagina. |
collection="star-trek" type="code1" id="startrek"
|
||
startrek_D_Count
|
1 |
Totaal aantal records aanwezig per gegenereerde pagina. De letter die is gebruikt om de paginanaam en het keyword te genereren is aanwezig in de stepvar-naam om deze uniek te maken. |
startrek_N_Count
|
8 |
|
startrek_O_Count
|
2 |
|
startrek_Count
|
11 |
Totaal aantal records aanwezig in de stepcollectie. |
startrek_PageKwCount
|
3 |
Aantal gegenereerde pagina's. |
startrek_PageKw_1
|
stepcollect__voorbeeld_per_alfabet_D |
De keywords van de gegenereerde pagina's (dewelke dus automatisch de gebruikte (eerste) letter van het code-veld bevat. |
startrek_PageKw_2
|
stepcollect__voorbeeld_per_alfabet_N |
|
startrek_PageKw_3
|
stepcollect__voorbeeld_per_alfabet_O |
|
collection="star-trek" type="codedot" id="startrek-perreeks"
|
||
startrek-perreeks_DS9_Count
|
1 |
Totaal aantal records aanwezig per gegenereerde pagina. De unieke tekst van het code-veld (alle karakters tot het eerste '.'-karakter) die is gebruikt om de paginanaam en het keyword te genereren is aanwezig in de stepvar-naam om deze uniek te maken. |
startrek-perreeks_NF_Count
|
5 |
|
startrek-perreeks_NG_Count
|
3 |
|
startrek-perreeks_OS_Count
|
2 |
|
startrek-perreeks_Count
|
11 |
Totaal aantal records aanwezig in de stepcollectie. |
startrek-perreeks_PageKwCount
|
4 |
Aantal gegenereerde pagina's. |
startrek-perreeks_PageKw_1
|
stepcollect_voorbeeld_codedot_DS9 |
De keywords van de gegenereerde pagina's (dewelke dus automatisch de gebruikte unieke tekst van het code-veld bevat. |
startrek-perreeks_PageKw_2
|
stepcollect_voorbeeld_codedot_NF |
|
startrek-perreeks_PageKw_3
|
stepcollect_voorbeeld_codedot_NG |
|
startrek-perreeks_PageKw_4
|
stepcollect_voorbeeld_codedot_OS |
|
Opmerkingen
- Zoals eerder vermeld dient elke gebruikte 'id'-waarde binnen het Sitestepperproject uniek te zijn. Dit om unieke stepvars te kunnen genereren (zie voorgaande tabel waar elke id is gemarkeerd, zowel op de stuurlijn, als in de namen van de automatisch gegenereerde stepvars.
- Deze stepvars kunnen, zoals reeds gezegd, worden gebruikt als elke andere stepvar, zowel op de bronpagina's van de stepcollecties zelf, als op andere pagina's (en zijn dus perfect bruikbaar in menu-systemen of overzichtpagina's naar uw collectietoe.
- De stepvars worden bewaard en zijn dus aanwezig in het project vanaf het moment dat ze éénmaal zijn aangemaakt.
- De waardes van de stepvars worden telkens aangepast zodra de StepCollectGen-actie opnieuw wordt uitgevoerd, dus deze kunnen perfect worden gebruikt om up-to-date informatie over de stepcollectie te tonen op de website.
Schema punt 5: builden van de pagina's
In de huidige versie van Sitestepper zullen de gegenereerde pagina's niet automatisch worden gebuild nadat ze via de StepCollectGen-actie zijn aangemaakt.
Ze zullen daarentegen worden verwerkt zoals alle andere pagina's in het Sitestepper-project. M.a.w. net zoals de webpagina's pas worden aangemaakt nadat een make- of buildactie werd gestart van heel het project (of van een deel van de projectboom), zo zullen ook de door StepCollectGen gegenereerde pagina's pas naar de website worden gekopieerd als webpagina's na het uitvoeren van een make- of buildactie.
Na het uitvoeren van de StepCollectGen-actie wordt de bronpagina die als basis dient voor de StepCollectie – dus diegene die stuurlijn voor StepCollect bevat – terug geactiveerd.
Desgewenst kan, op dat moment, de menu-optie 'Genereer – geselecteerde pagina' (F9) of 'Genereer – Build node'.worden gekozen om webpagina's aan te maken van de zonet gegenereerde bronpagina's.
Tip
- De 'Genereer – geselecteerde pagina'
is de beste keuze vermits hier de F9-sneltoets kan worden gebruikt.
Deze optie start een make-actie (die de tijd-en-datum van de bronpagina vergelijkt met de tijd-en-datum van de webpagina en alleen een webpagina zal genereren indien de tijd-en-datum van de bronpagina in het project nieuwer is dan de tijd-en-datum van de overeenkomstige webpagina, of indien de webpagina nog niet bestaat.
Vermits de bronpagina's zonet werden gegenereerd zijn deze dus altijd nieuwer dan eventueel eerder aangemaakte webpagina's en dus zal steeds een webpagina per gegenereerde bronpagina worden aangemaakt.
Schema punt 6: filter de te gebruiken records uit de StepCollecties
Sitestepper laat toe een filter te definiëren op de stuurlijn zodanig dat slechts een gedeelte van alle records in de aangeduide stepcollectie zal worden gebruikt om te worden getoond op de gegenereerde webpagina.
Deze filter wordt, net zoals alle andere parameters, op de stuurlijn van StepCollect geplaatst via de parameter: selection32.
De filter zal worden toegepast op de waarde van het code-veld.
Alleen die records waarvan de waarde van het code-veld voldoen aan de ingestelde filter, worden meegenomen in het uiteindelijk resultaat. Records waarvan de waarde van het code-veld niet voldoen aan de ingestelde filter, worden genegeerd en zullen derhalve niet worden gebruikt om de bronpagina('s) te genereren.
Formaat van de filter
Zoals reeds gezegd dient de filter voor te komen op de stuurlijn van StepCollect.
Bijvoorbeeld:
<!--StepCollect start collection="star-trek" id="startrek-filter" selection="%\.1$"-->HTMLcode 32: Filter opgenomen op de StepCollect stuurlijn.
De selectie opgenomen in voorgaand voorbeeld zal alleen die records selecteren in de stepcollectie genaamd 'star-trek' waarvan het code-veld eindigt op .1.
Indien de StepCollectGen wordt uitgevoerd, dan levert dit de volgende wegpagina op (de webpagina wordt getoond zonder filter (links) en mét filter (rechts).
Opmerkingen
- De stepvar die aanduidt hoeveel records
aanwezig zijn in de stepcollectie zal het aantal tonen van het
aantal geselecteerde records indien een filter aanwezig is.
Dit is te zien in voorgaande afbeelding in het omcirkeld aantal. In de oorspronkelijke pagina (zonder filter) zijn 11 records gevonden en aanwezig op de pagina. In de gefilterde pagina zijn slechts 4 records aanwezig na het toepassen van de filter en zijn dus maar 4 records aanwezig op de pagina. - Het code-veld is op de pagina's geplaatst zodanig dat perfect kan worden gezien dat de gefilterde pagina wel degelijk enkel die records bevat waarvan de code eindigt op '.1'.
- Het zal duidelijk zijn dat filters pas dan
kunnen worden gebruikt indien de waarde van de code-velden
eenduidig en volgens een vast stramien worden ingevuld. Waren de
Star Trek boeken van voorgaande boeken gewoon genummerd geweest
(1,2,3, enz...) als waarde in het code-veld dan was een filtering
zo goed als onmogelijk geweest.
Vermits werd gekozen om elke reeks een eigen nummering te geven en deze te laten voorafgaan door eenzelfde tekst per reeks, werd het mogelijk om zowel via de type='codedot' stuurparameter aparte pagina's aan te laten maken per reeks, maar ook om, zoals in voorgaand voorbeeld, een filter te plaatsen op, in dit geval, de eerste boek van elke reeks.
Formaat van de filterwaarde
Het formaat dat Sitestepper zal gebruiken als filterwaarde is het zeer populaire 'reguliere expressie'-formaat – misschien meer bekend onder de Engelse benaming: 'regular expressions'.
Dit formaat laat toe om eenvoudige tot zeer ingewikkelde patronen te definiëren door middel van een set van karakters waarbij sommige karakters een pre-gedefinieerde betekenis hebben.
Een korte beschrijving van de mogelijkheden volgt, maar wie meer informatie wenst over deze reguliere expressies kan het beste via één van de zoekmachines op het internet zoeken naar 'reguliere expressies' of 'regular expressions'.
Tip
- De zoekfunctie binnen het StepEdit-programma kan ook zoeken via reguliere expressies.
Kleine opsomming van de mogelijkheden van reguliere expressies
Een reguliere expressie is een patroon van karakters. Ze omschrijft een verzameling waardes zonder ze allemaal op te moeten noemen in een opsomming met de bedoeling een selectie te kunnen uitvoeren: welke tekst voldoet wel aan een bepaald patroon, welke tekst voldoet niet aan een bepaald patroon.
De drie teksten 'bal', 'bel' en 'boel' kunnen, bijvoorbeeld, beschreven worden met het patroon:
- b(a|e|oe)l
Alle drie de teksten zullen worden geselecteerd (gematchd met het patroon) zonder deze specifiek te moeten opsommen.
Gewone letters en cijfers in de reguliere expressie herkennen hetzelfde teken in de te matchen tekenreeks.
Een aantal tekens hebben echter een speciale betekenis. Indien dit teken wordt tegengekomen in een patroon, dan wordt niet gezocht naar dat specifieke teken, maar worden de eerstvolgende tekens in de te doorzoeken tekst onderzocht volgens volgende tabel:
|
Een punt (.) |
staat voor een willekeurig teken |
|
Vierkante haken [...] |
geven een lijst van mogelijke tekens: [abc]. |
|
Binnen vierkante haken staat een minteken voor een reeks |
[a-zA-Z] is het patroon waarmee alle letters "gevangen" worden |
|
Een dakje als eerste teken binnen de vierkante haken |
verandert de tekenverzameling in het omgekeerde: [^0-9] herkent alles wat geen cijfer is |
|
Een dakje (^) |
staat voor het begin van de regel. |
|
Een dollarteken ($) |
staat voor het eind van de regel. |
Deze basiselementen kunnen worden gecombineerd met de keuze, kwantificatie en een groepering, als volgt.
Keuze
Een verticale balk scheidt de alternatieven, bijvoorbeeld "groen|rood" herkent "groen" en "rood".
Kwantificatie
- Een zogenaamde kwantor achter een teken geeft aan hoe vaak dat teken mag voorkomen. De meest voorkomende kwantoren zijn +, ? en *. De volgende tabel geeft hun betekenis.
|
+ |
Een plusteken geeft aan dat het ervoorstaande teken tenminste één keer moet voorkomen, bijvoorbeeld "goo+gle" herkent google, gooogle, goooogle, enz. maar niet gogle. |
|
? |
Een vraagteken geeft aan dat het ervoorstaande teken ten hoogste één keer mag voorkomen, bijvoorbeeld De Bruij?n herkent De Bruin en De Bruijn., maar niet De Bruin. |
|
* |
Een sterretje geeft aan dat het ervoorstaande teken nul of meer keer mag voorkomen, bijvoorbeeld "0*42" herkent 42, 042, 0042, enzovoort. Dit is de meeste gebruikt kwantor vermits de * alle tekst matcht. |
|
Uitbreiding op de normale syntax van reguliere expressies door StepCollect |
|
|
% |
StepCollect laat toe om de '%'-kwantor te gebruiken in plaats van de '.*'-combinatie. Met andere woorrden: de '%' heeft exact dezelfde betekenis als '.*' en zal dus kunnen worden gebruikt als: eender welk teken dat nul, één keer of meerdere malen voorkomt. Het '%'-teken is opgenomen in de lijst van mogelijke kwantors vermits deze kwantor veel wordt gebruikt in databasequeries. Omdat StepCollect tenslotte ook een (mini-)databasetoepassing is, is het gebruik van de '%' een logische uitbreiding op de syntax van reguliere expressies. |
Groepering
Haakjes maken een eenheid van het patroon waar ze omheen staan, bijvoorbeeld "(va|moe)der" is hetzelfde als "vader|moeder" en "(groot)?vader" herkent zowel "vader" als "grootvader".
Kwantors gebruiken als normale karakters
Indien één van de kwantors moet worden gebruikt als normaal teken in het patroon dan dient dit te worden voorafgegaan door het escape-karakter: '\'.
De term escape-karakter wordt gebruikt omdat, door het gebruik van het '\'-karakter, het eerstvolgende karakter ontsnapt aan de normale betekenis binnen reguliere expressies, maar terug als normaal karakter wordt gebruikt.
Bijvoorbeeld: 'andere.\*' als patroon zoekt exact naar de tekst 'andere*' en niet naar alle teksten die beginnen met 'andere'.
Schema punt7: linken leggen tussen gegenereerde bronpagina's
StepCollect kan automatisch steplinken prepareren zodanig dat verschillende bron- of webpagina's die vertrekken vanaf dezelfde stepcollectie via steplinken aan elkaar gelinkt kunnen worden.
Dit wordt meestal gebruikt om op één pagina een overzicht te plaatsen van slechts enkele records uit een stepcollectie, waarbij elk tekst of afbeelding de overzichtspagina een link wordt naar een andere pagina met alle teksten of afbeeldingen van de daarbij horende records.
Deze ene pagina zal dan (bijvoorbeeld):
- van het type=all zijn (zodanig dat alle records slechts op één pagina worden geplaatst en dat dus maar één pagina wordt gegenereerd)
- een filter hebben ingesteld (om bijvoorbeeld, net als in de voorgaande besprekingen, enkel het eerste record van een reeks op de overzichtspagina te plaatsen)
- via het linkedkw-stuurparameter StepCollectGen de opdracht geven dit keyword te gebruiken om steplinken aan te maken dewelke dan kunnen worden gebruikt om vanuit deze ene pagina (step-)linken te leggen naar de pagina's aangemaakt met het type=codedot.
Syntax van de linkedkw stuurparameter
De stuurparameter linkedkw dient:
- voor te komen op de stepcollect-stuurlijn (zie het hoofdstuk Parameters van de StepCollect-startlijn op blz.237)
- een bestaand keyword te bevatten van een andere bronpagina voor de stepcollectie te bevatten
Linked keyword
StepCollect zal de waarde van de linkedkw-stuurparameter gebruiken om bijkomende stepvars aan te maken die alleen aanwezig zijn tijdens de verwerking van een record. Deze aangemaakte stepvars kunnen, net zoals alle andere stepvars die aanwezig zijn tijdens de verwerking van een record uit de stepcollectie worden ingevuld op de gegenereerde bronpagina (voor een volledige lijst: zie Lijst van stepvars aanwezig tijdens het genereren van de bronpagina's op pagina 238).
De stepvars zullen voor elk record een waarde bevatten samengesteld uit de tekst van linkedkw-stuurparameter aangevuld met dezelfde suffixen als besproken in Een unieke naam voor elke gegenereerde bronpagina op pagina 244.
Ter herinnering worden hier nogmaals de drie stepvars vermeld die voor elk record aanwezig zijn tijdens de verwerking van het record:
|
{stepcollect-linkedautomatic} |
|
{stepcollect-linkedcode1} |
|
{stepcollect-linkedcodedot} |
Door deze stepvars te gebruiken achter de link-syntax (zie Steples – linken leggen tussen verschillende apgina's) wordt het mogelijk om vanuit elk record aangemaakt met een bepaald type, een link te leggen naar elke andere set van automatisch gegenereerde bronpagina's.
Opmerkingen
- De waarde van de linkedkw-stuurparameter wordt exact gebruikt zoals deze aanwezig is tussen dubbele quotes op de stuurlijn. Er wordt, in de huidige versie van de Sitesteppersoftware geen test uitgevoerd of het opgegeven keyword bestaat in het project).
- Uiteraard heeft het dan ook geen zin om een niet bestaand keyword te gebruiken. Immers, vermits de inhoud van de stepvar op de gegenereerde pagina een Sitestepper keyword zal produceren, en dus als stepvar zal worden gebruikt, zal tijdens het bouwen van de volledige site, geen pagina worden gevonden die gekoppeld is aan het dit (onbestaand) keyword, en zullen derhalve al deze linken verwijzen naar de 'under construction' pagina.
Tutorial voor het aanmaken van StepCollect bronpagina's
De volgende tutorial kan worden gevolgd om in een bestaand project:
- Een stepcollectie aan te maken.
- Een bronpagina aan te maken die een overzicht zal tonen van een aantal van de records in deze stepcollectie.
- Een bronpagina aan te maken die per rubriek in de stepcollectie (waarbij rubriek wordt gedefinieerd als de tekst voor het eerste '.'-karakter van het code-veld) één pagina zal aanmaken.
- Er voor zal zorgen dat vanuit de overzichtspagina kan worden doorgeklikt naar de pagina's aangemaakt in punt 3
Opmerkingen
- Er zal slechts één tutorial
aanwezig zijn in dit hoofdstuk wat dan meteen alles uitlegt tot en
met het linken van twee stepcollect-bronpagina's.
Het zal duidelijk zijn dat, indien deze linking, niet nodig is, gewoon de stuurparameter linkedkw='' dient te worden verwijderd. De rest van de handelingen blijven gelijk. - De tutorial zal zijn opgevat als een puntenlijst die kan worden gevolgd. Waar nodig zullen opmerkingen geïntendeerd worden weergegeven tussen de punten.
Gebruikte stepcollectie voor de tutorial
Voor deze tutorial zal de Star Trek collectie worden gebruikt. Deze is, in een standaard Sitestepper-installatie, meegeleverd.
Stappen te volgen indien een eigen stepcollectie wordt gebruikt tijdens de tutorial
U kan, natuurlijk, perfect een eigen stepcollectie opbouwen (zie Schema punt 1: Editeer de stepcollectie via het StepCollect programma op pagina 213 voor een uitgebreide beschrijving hoe een stepcollectie kan worden aangemaakt).
Teneinde mooie resultaten van de tutorial te kunnen tonen, dient u:
- Verschillende records in te geven.
- Een afbeelding bij te voegen aan elk
record.
Deze stap is niet absoluut noodzakelijk, natuurlijk, maar het maakt de tutorial wel wat visueler. - In het code veld van de verschillende records, verschillende rubrieken in te voeren – waarbij een rubriek een willekeurige tekst is, en vermits de lengte van het code-veld beperkt is (slechts 16 karakters)
- Elke rubriek in het code veld dient gevolgd te worden door een '.'-karakter
- Achter het '.'-karakter dienen nog wat karakters of een nummer te worden getypt - vermits het code-veld van elke record uniek moet zijn binnen een stepcollectie kunnen geen twee records worden ingevoerd met dezelfde rubriek gevolgd door een '.'-karakter vermits dan beide waardes van beide code-velden gelijk zijn.
Zie als voorbeeld voor een bruikbare stepcollectie de Star Trek collectie of bekijk de records opgesomd in tabel 18 op pagina 241.
De reeksen van Star Trek zijn gebruikt als rubrieken, elke rubriek (reeks) is gevolgd door een '.'-karakter en de volgorde van elke reeks is bepaald door een nummer te plaatsen ná het '.'-teken.
Een collectie die op dergelijke manier is opgebouwd mag tientallen of zelfs honderden records bevatten en is ideaal om automatisch tientallen pagina's te genereren om uw volledige collectie in al zijn glorie op uw website te kunnen plaatsen.
Tutorial stap 1: een stepcollectie aanmaken
Hoe een stepcollectie dient te worden aangemaakt en kan worden aangepast is volledig besproken in Schema punt 1: Editeer de stepcollectie via het StepCollect programma op pagina 213. Deze stappen zullen hier dan ook niet worden herhaald.
Onthou de naam van de stepcollectie
Het enige belangrijke dat hier dient te worden onthouden is de naam van de stepcollectie vermits we deze dienen te specificeren op de StepCollect-stuurlijnen die we in stap 2 en stap 3 gaan opbouwen. We moeten immers aangeven aan StepCollectGen (het programma dat de bronpagina's zal genereren), welke stepcollectie dient te worden gelezen om de webpagina's aan te maken.
In voorgaande afbeelding is aangeduid waar de naam van de stepcollectie te zien is in het StepCollect-programma.
Tutorial stap 2: een overzichtpagina aanmaken
Deze tutorial zal de pagina's aanmaken in het Nederlands en als .htm-pagina's, dus dienen de bronpagina's te worden aangemaakt in de Web-sectie van de projectboom.
- Rechts-klik de 'Web' tak in de projectboom en kies 'Nieuwe pagina'.
- Geef als naam van de nieuwe pagina: 'Star Trek collectiepaginas'.
Opmerking:
De zonet aangemaakte tak in de projectboom zal worden gebruikt als parent om alle StepCollect-pagina's van Star Trek in onder te brengen.
Dit groepeert niet alleen bij elkaar horende pagina's (wat altijd een goede manier om uw werk te ordenen), maar laat ook toe om voor deze set van bij elkaar horende pagina's éénmalig een skeleton in te stellen. Vermits alle children aangemaakt onder een parent-pagina in de projectboom automatisch dezelfde skeleton krijgen toegewezen zodra ze worden aangemaakt, bekomen we zo op een zeer gemakkelijke manier een eenvormigheid voor deze hele sectie.
Tevens laat dit ons toe om de hele sectie van bij elkaar horende StepCollect-pagina's te builden naar de website toe (selecteer de zonet aangemaakte parentpagina en kies de menu-optie: 'Genereer – geselecteerde pagina (F9)' of 'Genereer – build node'. Vermits deze opties de huidige pagina én alle children zal verwerken is dit een zeer gemakkelijke manier om alle pagina's de we aan het aanmaken zijn te builden (zonder steeds de hele site of individuele pagina's te moeten builden).
- Er zal geen keyword worden toegekend aan deze pagina (want ze dient enkel en alleen als groeperingspagina in de projectboom. Ze zal dan ook schuin en lichtgrijs worden weergegeven.
- Indien een speciale skeleton is aangemaakt voor deze sectie van de website, kan deze nu worden toegekend aan de aangemaakte parentpagina. Druk op 'Ctrl-E' ('Edit – Node data – Editeer'), en kies de skeleton uit de skeletonlijst. Druk daarna op 'Ctrl-S' (Edit – Node data – Opslaan).
Opmerking:
Indien nu nog geen skeleton is aangemaakt voor deze sectie van de website, kan dit op een later tijdstip nog steeds worden gedaan en kan d.m.v. de menu-optie: 'Node – meer acties... – vervang skeleton, de aangemaakte skeleton worden toegekend aan zowel de tak 'Star Trek collectiepagina's' én alle children van deze tak (nog een reden om gelijkaardige pagina's onder eenzelfde parent te plaatsen).
- Rechts-klik de zonet aangemaakte 'Star Trek collectiepaginas' en kies 'Nieuwe pagina'.
- Geef als naam van de nieuwe pagina 'Overzicht van de Star Trek reeksen'.
- Druk 'Ctrl-E' (Edit – Node date – Editeer), en vul een uniek (binnen het project) en duidelijk keyword in: 'stepcollectie_startrek_overzicht'. Onthou die keyword want dat gaan we later nodig hebben om linken te leggen.
Tip
Start of eindig elk keyword dat wordt gebruikt voor een StepCollect-bronpagina met 'stepcollect' of 'stepcollectie' of met ander eenzelfde tekst. Dit maakt het zeer gemakkelijk om later de desbetreffende pagina op te zoeken ('Ctrl-L' of 'Node – Locate') vermits in de zoeklijst een filterterm kan worden ingevuld (om alleen die pagina's te laten zien die een bepaalde term bevatten). Indien alle stepcollectie-pagina's eenzelfde tekst het keyword bevat, kan deze tekst worden gebruikt als filter om alleen die pagina's te tonen die binnen het StepCollect-gebeuren in gebruik zijn.
- Editeer de Nederlandstalige bronpagina van deze tak door 'Alt-2' in te drukken (Editeer – NL) of de 'NL' knop rechts in de talenbalk aan te klikken.
- Voer de volgende html-code in. Ter illustratie is het deel dat zal worden gebruikt door StepCollect om te worden herhaald per record in het blauw aangeduid, terwijl de achtergrond van de twee stuurlijnen donkerblauw zijn gekleurd.:
<h1>Star Trek</h1>
Er zijn <b>{st-overzicht_count}</b> verschillende Star Trek reeksen.
<table width="400"cellpadding="2"cellspacing="0"border="1"bordercolor="white" bgcolor="#0080FF">
<!--StepCollect start collection="star-trek" id="st-overzicht" selection="%\.1$".. linkedkw="stepcollectie_startrek_perreeks"--><tr><td width="400">{StepCollect-RecNr}:<b>{StepCollect-Title}</b><br>
<i>{StepCollect-SubTitle}</i>
<br><br><a href='http://www.sitestepper.be/nl/__underconstruction__.htm'>Bekijk alle boeken uit deze serie</a>
<br><br>Code: {StepCollect-Code}</td><td width="150" align="center" valign="middle">
<img src="{StepCollect-Picture}"border="0"height="100">
</td></tr><!--StepCollect end--></table>
Een beschrijving van de lijnen in deze html-code volgt na de opsomming van de te volgen punten.
- Bewaar het bestand door in StepEdit het bestand te bewaren door het indrukken van Ctrl-S ('Bestand – Opslaan').
- Activeer StepGen door (vanuit StepEdit) F12 te drukken ('Sitestepper – Activeer StepGen'). De laatst aangemaakte tak is nog steeds actief.
- Genereer de bronpagina startende vanaf deze stepcollectie: kies de menu-optie: 'Genereer - Genereer Stepcollectpagina's'.
- Klik 'Creëer' in het StepCollect-scherm
dat wordt geopend. Eén nieuwe pagina wordt automatisch
aangemaakt onder de huidige pagina.
Deze pagina heeft de naam: 'Overzicht van de Star Trek reeksen-automatic'.
De bronpagina waarop rechts werd geklikt in de vorige stap, blijft geselecteerd (of wordt opnieuw geselecteerd na het genereren). - Build de tak: F9 ('Genereer – Geselecteerde pagina').
- Selecteer de aangemaakte pagina ('Overzicht van de Star Trek reeksen-automatic') en kies 'View – Toon huidige pagina' of druk Ctrl-F8.
- De automatisch aangemaakte pagina met het overzicht van alle reeksen zal worden opgestart in de standaard ingestelde internetbrowser.
Opmerkingen
Bemerk de omcirkelde 4 in voorgaande afbeelding. StepCollect heeft automatisch het aantal verschillende reeksen gedetecteerd en deze via een stepvar aangeboden op de pagina.Bij het builden van de pagina is de desbetreffende stepvar dan ook vervangen door het gevonden aantal.
Het getoonde scherm is een beetje naar onder gescrold om de 4 reeksen te tonen.
Ter illustratie is de achtergrond van de tabel op de van deoverzichtspagina blauw gekleurd. Dit in contrast met de pagina's per reeks waar de achtergrond roodbruin zal worden gekleurd.
Bespreking van det html-code
Hierna volgt een regel voor regel bespreking van de html-code in kader 28. Dezelfde nummering als de nummering in dit kader wordt gebruikt in de volgende besprekingen.
1) <h1>Star Trek</h1>
Regel 1 bevat de titel van de pagina.
2) Er zijn <b>{st-overzicht_count}</b> verschillende Star Trek reeksen.
Voor zoek-engines als Google, Yahoo en MSN is het steeds aan te raden een hoofding van het hoogste level (level 1) bovenaan elke pagina te plaatsen.
StepGen maakt automatisch stepvars aan bij het genereren van de StepCollect-pagina's. Vermits deze stepvars bewaard worden in het Sitestepper-project, kunnen deze worden gebruikt op elke pagina, dus óók op de gegenereerde pagina.
Eén van de aangemaakte stepvars is de' _count' suffix toegevoegd achteraan de id op de StepCollect-stuurlijn (zie de bespreking van lijn 4 hierna).
In dit geval is de id gelijk aan 'st-overzicht' en bijgevolg noemt de automatisch aangemaakte stepvar 'st-overzicht_count'.
Vermits deze sterpvar automatisch het aantal verwerkte records krijgt toegewezen (en we een filter hebben geplaatst), krijgt en behoudt deze stepvar dus de waarde 4.
3) <table width="400"cellpadding="2"cellspacing="0"border="1"bordercolor="white" bgcolor="#0080FF"> ... 19)</table>
Voor deze pagina's is gekozen om de verschillende record te tonen door middel van een html-tabel.
Tabellen en dus ook html-tabellen zijn nu eenmaal ideaal om een set van gegevens in verschillende kolommen en rijvorm te laten zien waarbij elke rij overeenkomt met één record van de stepcollectie en de verschillende kolommen zullen ingevuld worden met de waardes uit de verschillende velden van elk record.
De tabeldefinitie dient slechts éénmaal voor te komen op een pagina en dus zijn de start- en eindlijnen van de tabeldefintie buiten het StepCollect-deel geplaatst. Het StepCollect-deel zal zoveel maal worden herhaald als er records geselecteerd zijn.
De gebruikte parameters van de <table>-htmltag zijn allemaal standaardparameters dus deze worden hier niet besproken. De enige parameter die hier even besproken wordt is bgcolor die, zoals eerder besproken, hier is ingevuld met een blauwe kleur ("#0080FF"= [ deze kleur ]) om een visueel onderscheid te maken met de pagina's die in stap 3 zullen worden gegenereerd.
... 5) <tr><td width="400">... ... 14)</td> 15)<td width="150" align="center" valign="middle"> ... 17)</td></tr> ...
Het deel van de tabel dat zal worden herhaald (en dat zich dus tussen de twee stuurlijnen van de stepcollectie moeten bevinden) zijn normale definities van tabel records (<tr>..</tr>) en tabel kolommen (<td>..</td>). Het voorgaande kader toont de lijnen zonder de stepvars – dus enkel die html-elementen die betrekking hebben op de buiten dit deel gestarte html-tabel.
Het lichtblauwe deel zal dan ook zoveel maal voorkomen op de gegenereerde pagina als er records werden gevonden.
Met andere woorden: de inhoud van het lichtblauwe deel zal met elk record worden samengevoegd, waarna de samengevoegde lijnen in de te genereren bronpagina wordt geplaatst.
Het is tijdens dit samenvoegen dat de StepCollect-stepvars (zoals beschreven in tabel 15 op pagina 215) worden vervangen door de waardes van de overeenkomstige kolom van de actuele record.
De zelfde lijnen getoond met de stepvars ingevuld:
... 5) <tr><td width="400"> {StepCollect-RecNr}: 6) <b>{StepCollect-Title}</b><br> 7) <i>{StepCollect-SubTitle}</i> 8) <br> 9) <br> 10)<a href='http://www.sitestepper.be/nl/__underconstruction__.htm{StepCollect-LinkedCodeDot}'>Bekijk alle boeken uit deze serie</a> 11)<br> 12)<br> 13)Code: {StepCollect-Code} 14)</td> 15)<td width="150" align="center" valign="middle"> 16)<img src="{StepCollect-Picture}"border="0"height="100"> 17)</td></tr> ...
Op lijn 5 wordt de stepvar gebruikt, deze zal worden vervangen door een opeenvolgend nummer. Met andere woorden, zijn er 10 records, dan krijgt de eerste maal dat dit deel wordt bijgevoegd aan de gegenereerde bronpagina, de waarde 1, de tweede maal dat dit deel wordt bijgevoegd aan de gegenereerde bronpagina, de waarde 2 tot en met de laatste maal de waarde 10.
Zijn er slechts 4 records (zoals in deze tutorial), dan zal deze stepvar een waarde 1 tot en met 4 krijgen.
Lijn 6 en 7 zal de waarde van de overeenkomstige title en subtitle velden tonen.
Lijn 10 gebruikt de waarde van de stepvar {StepCollect-LinkedCodeDot}.
Deze stepvar krijgt een waarde die gelijk is aan:
- de waarde van de stuurparameter 'linkedkw'
- aangevuld met dezelfde suffix als zou deze record zijn gegenereerd naar een pagina via de type=codedot methode.
Door in linkedkw een bestaand keyword te plaatsen van een bestaande bronpagina van een StepCollect-pagina van het type=codedot, krijgen we wat we wensen.
Op de plaats van de wordt in de gegenereerde pagina een keyword geplaatst naar een bestaande pagina.
Opmerking
- Uiteraard bestaat deze pagina pas nadat a) de andere bronpagina voor de stepcollectie is aangemaakt en b) StepCollect al de pagina's heet kunnen aanmaken.
- Op dit moment in de tutorial zijn deze pagina's nog niet aangemaakt, maar toch desondanks kunnen we pagina al laten genereren. Moest de gegeneerde pagina nu reeds worden gebuild, dan zouden deze linken automatisch verwijzen naar de "_under_construction_" pagina.
4) <!--StepCollect start collection="star-trek" id="st-overzicht" selection="%\.1$".. linkedkw="stepcollectie_startrek_perreeks"--> ... 18) <!--StepCollect end-->
Lijn 13 toont de inhoud van het code-veld (en dit vooral ter info in deze tutorial). In 'echte' webpagina's heeft de bezoeker allicht geen boodschap aan de waarde van dit veld.
De twee belangrijkste lijnen zijn voor het laatst bewaard ☺.
Het zijn deze beide lijnen die de bronpagina een stuurpagina maken voor StepCollect.
Beide lijnen zijn normale html-commentaarlijnen. Ze beginnen met '<!--' en eindigen met '-->' (de start-en eindtags voor commentaar binnen html-bestanden). In het StepEditprogramma worden commentaarlijnen grijs getoond.
Beide stuurlijnen dienen te beginnen met de tekst 'StepCollect'. De startlijn dient gevolgd te worden door exact één spatie en de tekst 'start', de eindlijn dient gevolgd te worden door exact één spatie en de tekst 'end'.
De startlijn is aangevuld met de volgende stuurparameters (voor een volledige bespreking van alle mogelijke stuurparameters, zie pagina 237).
- collection="Star-Trek": de stepcollectie die dient te worden gelezen en dus de gegevens zal aanleveren voor de te genereren pagina
- id="st-overzicht": een uniek woord dat zal worden gebruikt om stepvars aan te maken die kunnen gebruikt worden om o.a. het aantal records op de pagina te tonen (zie de bespreking van lijn 2).
- selection="%\.1$": de filter die aanduidt welke records uit de stepcollectie dienen te worden gelezen. De syntax van deze stuurparameter is volgens de syntax van reguliere expressies (zie Kleine opsomming van de mogelijkheden van reguliere expressies op pagina 251).
- de selectiewaarde verklaard, karakter per
karakter:
%: nul of meerdere karakters
\.: exact een punt (het '\'-karakter is een escape-karakter om aan te duiden dat het punt als punt moet worden beschouwd, dus als karakter '.' en niet als het stuurkarakter van reguliere expressies waar '.' betekent: eender welk karakter
$: einde van de te doorzoeken tekst - Concreet betekent "%\.1$" dus: alle teksten die eindigen op .1. Als we de lijst van records bekijken selecteren we hiermee dus elk eerste record van elke serie (net wat we nodig hebben).
Tutorial stap 3: 1 pagina aanmaken per rubriek
Deze stap zal in vele gevallen gelijk lopen met de stappen in stap 2. de stappen zullen worden herhaald, maar als uitleg worden enkel die dingen verklaard die andes zijn dan de stappen in stap 2 van de tutorial.
- Rechts-klik de in stap 2 van de tutorial aangemaakte 'Star Trek collectiepaginas' en kies 'Nieuwe pagina'.
- Geef als naam van de nieuwe pagina 'Boeken per Star Trek reeks'.
- Druk 'Ctrl-E' (Edit – Node date – Editeer), en vul hetzelfde keyword in dat werd gebruikt als waarde van de stuurparameter linkedkw op lijn 4 van de code van de bronpagina van de Star Trek overzichtspagina (zie HTMLcode 28: StepCollect stuurlijnen op pagina 237): 'stepcollectie_startrek_perreeks'.
- Editeer de Nederlandstalige bronpagina van deze tak door 'Alt-2' in te drukken (Editeer – NL) of de 'NL' knop rechts in de talenbalk aan te klikken.
- Voer de volgende html-code in.
<h1>Boeken per Star Trek reeks</h1>
U ziet hier een selectie uit de in totaal {st-perreeks_count} boeken aanwezig<table width="400"cellpadding="2"cellspacing="0"border="1"bordercolor="white" bgcolor="#0080FF">
<!--StepCollect start collection="star-trek" type="codedot" id="st-perreeks" linkedkw="stepcollectie_startrek_overzicht"--><tr><td width="400">{StepCollect-RecNr}:<b>{StepCollect-Title}</b><br>
<i>{StepCollect-SubTitle}</i>
<br><br><a href='http://www.sitestepper.be/nl/__underconstruction__.htm'>Terug naar het overzicht van alle series</a>
<br><br>Code: {StepCollect-Code}</td><td width="150" align="center" valign="middle">
<img src="{StepCollect-Picture}"border="0"height="100">
</td></tr><!--StepCollect end--></table>
- Bewaar het bestand door in StepEdit het bestand te bewaren door het indrukken van Ctrl-S ('Bestand – Opslaan').
- Activeer StepGen door (vanuit StepEdit) F12 te drukken ('Sitestepper – Activeer StepGen'). De laatst aangemaakte tak is nog steeds actief.
- Genereer de bronpagina startende vanaf deze stepcollectie: kies de menu-optie: 'Genereer - Genereer Stepcollectpagina's'.
- Klik 'Creëer' in het StepCollect-scherm
dat wordt geopend. Er zullen evenveel pagina's wordn aangemaakt als
er unieke rubrieken zijn: in deze tutorial dus 4 pagina's.
Deze pagina's hebben de namen: 'Boeken per Star Trek reeks-DS9', 'Boeken per Star Trek reeks-NF', 'Boeken per Star Trek reeks-NG' en 'Boeken per Star Trek reeks-OS', dus steeds de naam van de bronpagina aangevuld met de rubriek.
De bronpagina waarop rechts werd geklikt in de vorige stap, blijft geselecteerd (of wordt opnieuw geselecteerd na het genereren). - Build de tak: F9 ('Genereer – Geselecteerde pagina').
- Selecteer één van de aangemaakte pagina (bijvoorbeeld: 'Boeken per Star Trek reeks-NF') en kies 'View – Toon huidige pagina' of druk Ctrl-F8.
- De automatisch aangemaakte pagina met de boeken van rubriek OS (Original Series) wordt geopend in het standaard ingestelde browserprogramma.
Tutorial stap 4: klikken tussen de verschillende gegenereerde pagina's
Indien alle pagina's zijn aangemaakt en de gegenereerde pagina's zijn gebuild naar de website toe, dan zal tussen de pagina's geklikt kunnen worden door te klikken op de link: 'Bekijk alle boeken uit deze serie' in de overzichtspagina en de linken 'Terug nar het overzicht van alle series' in de pagina's per reeks.
De volgende tabel toont alle elementen in beide pagina's die hiervoor hebben gezorgd.
|
TUTORIAL STAP 2 |
TUTORIAL STAP 3 |
|---|---|
|
Naam van de stuur-bronpagina: |
|
|
Overzicht van de Star Trek reeksen |
Boeken per Star Trek reeks |
|
Keyword toegekend aan de stuurpagina |
|
|
stepcollectie_startrek_overzicht |
stepcollectie_startrek_perreeks |
|
Stuurparameter type |
|
|
type=all33 |
type=codedot |
|
Stuurparameter linkedkw |
|
|
linkedpw=stepcollectie_startrek_perreeks |
linkedkw=stepcollectie_startrek_overzicht |
|
Aangemaakte pagina('s) in het project |
|
|
Slechts 1 pagina: Overzicht van de Star Trek reeksen_automatic |
1 pagina per reeks: Boeken per Star Trek reeks-DS9 Boeken per Star Trek reeks-NF Boeken per Star Trek reeks-NG Boeken per Star Trek reeks-OS |
|
Na een build zijn deze webpagina's
aanwezig: |
|
|
1 pagina: http://www.sitestepper.dev/eerste-website/nl/overzicht-van-de-star-trek-reeksen-automatic.htm |
|
|
de 4 pagina's: 1 pagina per reeks: http://www.sitestepper.dev/eerste-website/nl/boeken-per-star-trek-reeks-ds9.htm http://www.sitestepper.dev/eerste-website/nl/boeken-per-star-trek-reeks-nf.htm http://www.sitestepper.dev/eerste-website/nl/boeken-per-star-trek-reeks-ng.htm http://www.sitestepper.dev/eerste-website/nl/boeken-per-star-trek-reeks-os.htm |
|
|
Link geplaatst in het stuurgedeelte (om een link te kunnen leggen) |
|
|
<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'>Bekijk alle boeken uit deze serie</a> |
<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'>Terug naar het overzicht van alle series</a> |
|
Dezelfde link op de gegenereerde bronpagina |
|
|
<a href='http://www.sitestepper.be/nl/__underconstruction__.htmstepcollectie_startrek_perreeks_DS9'>Bekijk alle boeken uit deze serie</a> <a href='http://www.sitestepper.be/nl/__underconstruction__.htmstepcollectie_startrek_perreeks_NF'>Bekijk alle boeken uit deze serie</a> <a href='http://www.sitestepper.be/nl/__underconstruction__.htmstepcollectie_startrek_perreeks_NG'>Bekijk alle boeken uit deze serie</a> <a href='http://www.sitestepper.be/nl/__underconstruction__.htmstepcollectie_startrek_perreeks_OS'>Bekijk alle boeken uit deze serie</a> |
|
|
<a href='http://www.sitestepper.be/nl/__underconstruction__.htmstepcollectie_startrek_overzicht_automatic'>Terug naar het overzicht van alle series</a> |
|
|
En nogmaals deze linken op de gegenereerde
webpagina's |
|
|
<a href='http://www.sitestepper.dev/eerste-website/nl/boeken-per-star-trek-reeks-ds9.htm'>Bekijk alle boeken uit deze serie</a> <a href='http://www.sitestepper.dev/eerste-website/nl/boeken-per-star-trek-reeks-nf.htm'>Bekijk alle boeken uit deze serie</a> <a href='http://www.sitestepper.dev/eerste-website/nl/boeken-per-star-trek-reeks-ng.htm'>Bekijk alle boeken uit deze serie</a> <a href='http://www.sitestepper.dev/eerste-website/nl/boeken-per-star-trek-reeks-os.htm'>Bekijk alle boeken uit deze serie</a> |
|
|
<a href='http://www.sitestepper.dev/eerste-website/nl/overzicht-van-de-star-trek-reeksen-automatic.htm'>Terug naar het overzicht van alle series</a> |
|
Tabel 24: Elementen die bijdragen tot het linken tussen StepCollecties
Geavanceerde technieken: gebruik van de gegenereerde _count-stepvars
De tabel in hoofdstuk 'Automatisch gegenereerde stepvars na het uitvoeren van bovenstaande acties' op pagina 248 toont verschillende stepvars die worden aangemaakt door de StepCollect-actie uit te voeren.
Deze stepvars worden bewaard in het Sitestepper-project en kunnen derhalve worden gebruikt om op de gegenereerde pagina's te worden gebruikt. Vermits het echter 'normale' stepvars zijn, kunnen ze ook worden gebruikt op andere bronpagina's.
De enige, op die manier gegenereerde stepvars die in de tutorial zijn gebruikt, zijn 'st-overzicht_count' en 'st-perreeks_count'.
In tabel 17 op pagina 240, zijn echter nog andere stepvars aanwezig.
Enkele van deze stepvars zullen worden gebruikt om bovenaan elke Star Trek pagina een menu-systeem te plaatsen met een verwijzing naar elke reeks. Om de tutorial nog wat interessanter te maken, zullen we het Star-Trek menu in een bronpagina in de 'Includes'-sectie plaatsen en vervolgens, via een nieuwe skeleton 'StarTrek' deze bronpagina toevoegen aan elke pagina die deze nieuwe skeleton krijgt toegewezen.
Tutorial _count stepvars stap 1: aanmaken van de bron-menu-pagina
- Rechts-klik op de 'Includes' tak van de projectboom en kies 'Nieuwe pagina' (Ctrl-N).
- Geef als naam van de nieuwe pagina: 'Star Trek reeksen menu'.
Tip
Ook hier is het aan te raden om steeds het woord 'menu' op te nemen in de naam van de bronpagina of het toe te kennen keyword, vermits ook dit, het opzoeken (via Node – Locate (Ctrl-L) vergemakkelijkt. Want op deze manier kan dan door het intypen van 'menu' in het locate- of zoekscherm de lijst worden beperkt tot alle menu's.
- Druk 'Ctrl-E' (Edit – Node data – editeer) of voer 'startrek_menu' in als keyword.
- Editeer de Nederlandstalige bronpagina van deze tak door 'Alt-2' in te drukken (Editeer – NL) of de 'NL' knop rechts in de talenbalk aan te klikken.
<div style='border:1px solid white;background-color:#004040;margin:5px;padding:3px;text-algin:center;font-size:9px;'>
<i><b>Star-Trek: To Boldly Go Where no Website Has Gone Before.</b></i>
Kies:<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'> Deep Space 9 boeken</a>
<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'> New Frontier boeken</a> |
<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'> Next Generation boeken</a> |
<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'> Original Series boeken</a> |
</div>
Voer de volgende html-code in.
Opmerkingen
De <a href=...></a> kan in StepEdit zeer gemakkelijk worden ingevoerd.
Druk op Ctrl-L (Invoegen – StepLink) en type 'perreeks' in het filter veld. De getoonde lijst van bronpagina's zal zich beperken tot enkel die bronpagina's of keywords die de ingevoerde tekst bevatten.
Selecteer één van de pagina's en klik 'Use'.
De volledig correcte syntax voor een steplink zal worden ingevoerd.
Voer dit uit voor de 4 aanwezige bronpagina's (deze met de reeks-suffix).
- Bewaar dit bronbestand door, in StepEdit, Ctrl-S te drukken (Bestand – Opslaan).
Tutorial _count stepvars stap 2: een nieuwe skeleton aanmaken
De aangemaakte bronbestand in de 'includes' sectie zou nu moeten voorkomen op elke pagina dewelke de stepcollectie 'Star-Trek' gebruikt.
Dit kan worden opgelost door:
- Een nieuwe skeleton aan te maken (een kopie van een bestaande) en daar een StepIncl-lijn toe te voegen die het zonet aangemaakt bronbestand gebruikt.
- Deze nieuwe skeleton toe te kennen aan alle pagina's die worden gegenereerd tijdens de StepCollect-acties.
- Deze pagina's opnieuw te builden.
De volgende stappen zullen deze acties uitvoeren.
- Klik de parentpagina aan die is aangemaakt om alle Star-Trek stepcollectie-pagina's te bevatten.
-
Duk 'Ctrl-E' (Edit – Node data – editeer) of voer 'startrek_menu' in als keyword. - Open de lijst met aanwezige skeletons door op de 'selecteer' knop te klikken naast het skeleton-veld, en kies '<new skeleton>'.
- Geef de nieuwe skeleton de naam 'Star Trek boeken'. De nieuwe skeleton wordt aangemaakt en toegekend aan de geselecteerde bronpagina. Elke nieuwe skeleton die op deze manier wordt aangemaakt is een kopie van de skeleton 'default'.
-
Bewaar deze instelling door 'Ctrl-S' te drukken ('Editeer – Node data – Opslaan'). - Editeer de skeleton: met de 'Star Trek collectiepaginas' nog steeds geselecteerde in de projectboom, kies de menu-optie 'Skeleton – Editeer skeleton' (Ctrl-Alt-0) (of dubbelklik de 'star trek boeken' skeleton in de 'Skeletons'-tab van de 'tabbladen projectbestanden'.
- Vul de getoonde skeleton aan met de gemarkeerde lijn:
<html><head><!-- Created by {@ProgramVersion} on {@RunDate} at {@RunTime}.--><!-- Filename {Filename} merged with {SkeletonName} --><link href="{#webroot}/Styles/default.css" rel="stylesheet">
<title>{#StoreName} - {#StoreDescription} - {Filename}</title>
<!--StepIncl MetaTags--></head><body><!--StepIncl JavaScripts--><!--StepIncl Header--><!--StepIncl AndereTaal--><center><table width="760" border="0">
<tr height="350" valign="top">
<td width="150" valign="top" align="left">
<!--StepIncl Navigatie--></td><td width="610" valign="top">
<!--StepIncl startrek_menu--><!-- ******************************************************************* --><!-- ******** S T A R T ******************************************** --><!-- ******************************************************************* --><!--StepIncl @self--><!-- ******************************************************************* --><!-- ******** E I ND E ********************************************* --><!-- ******************************************************************* --></td></tr><tr><td colspan="2" align="center">
<br><!--StepIncl navigatie_footer--></td></tr></table><!--StepIncl Footer--></center></body></html>
Tutorial _count stepvars stap 3: nieuwe skeleton toewijzen aan alle star trek pagina's
Nu de nieuwe skeleton is aangemaakt, dient deze nog te worden toegewezen aan alle pagina's die worden aangemaakt tijdens de StepGen-acties.
- Selecteer de parent-pagina van de bronpagina's van de Star Trek boeken van deze tutorial: 'Star Trek collectiepaginas'.
- Kies de menu-optie: 'Node – Meer acties... - vervang skeleton'.
- Selecteer de nieuw aangemaakte skeleton 'Star Trek boeken' uit de getoonde lijst (van alle aanwezige skeletons in het project)
-
Click 'Ok'. De volgende vraag zal worden gesteld: -
Klik 'Ja': automatisch zullen alle kinderen van de geselecteerde pagina's, de geselecteerde skeleton toegewezen krijgen.
Tutorial _count stepvars stap 4: builden van de pagina's
- Met de pagina 'Star Trek collectiepaginas' nog steeds geselecteerd, kies de menu-optie: 'Genereer – Build node'.
- Vermits alle pagina's die worden gegenereerd kinderen zijn van deze ene pagina, worden deze pagina's allemaal gebuild naar de website toe.
- Verifieer of het menu gelukt is:selecteer de pagina ''Overzicht van de Star Trek reeksen_automatic' (de gegenereerde ovezichtspagina), en druk Ctrl-F8 (View – Toon huidige pagina') en klik door op enkele linken.
-
De getoonde aantallen zullen automatisch door Sitestepper up-to-date worden gehouden via de gebruikte stepvars , , en . Telkens een StepGen-actie wordt gestart, worden deze automatisch aangepast met het correct aantal gevonden boeken per reeks.
Opmerkingen
- Alhoewel de aantallen automatisch door Sitestepper worden aangepast, dient het eigenlijke menu manueel te worden onderhouden. Sitestepper kan immers niet weten of er rubrieken zijn bijgekomen of verwijderd.
Geavanceerde technieken: een stepcollectie tonen in verschillende kolommen
De tot nu getoonde stepcollecties werden allemaal d.m.v. een html-tabel getoond op de website.
Dit is ook logisch, een html-tabel is uitermate geschikt om gegevens in kolom en rij-vorm weer te geven.
Vermits het stuurgedeelte van een Stepcollect-bronpagina zoveel maal wordt herhaald als er records geselecteerd zijn in de aangeduide stepcollectie, is een <TR>...</TR>-rij van een html-tabel de meest logische keuze.
Hebt u kennis van de .asp of .php-taal, dan zijn meer complexe layouts mogelijk door de waardes van de -stepvars (zie tabel 15 op pagina 215) door te geven aan .asp of .php-routines en in deze routines de formattering uit te voeren d.m.v. code.
Maar wat als u toch verschillende records van een stepCollectie naast elkaar wenst te tonen en u hebt niet de kennis van een programmeertaal ?
Dit kan perfect worden bereikt door het gebruik van het html <div>-element en het gebruik van de stuurparameters: breakafter="nummer".
Nummer dient een numeriek geheel getal te zijn, en zal het aantal kolommen weergeven die u wenst te gebruikt op uw webpagina.
Bijvoorbeeld
- breakafter="2" – twee kolommen op de pagina
- breakafter="5" – vijf kolommen op de pagina
Indien deze breakafter-stuurparameter aanwezig is, dan zal StepCollect een bijkomende StepVar aanmaken genaamd: {stepcollect-breaktag}.
De {stepcollect-breaktag}-stepvar zal een waarde krijgen afhankelijk van het recordnummer van het huidige record.
Zodra het recordnummer deelbaar is door de numerieke waarde opgegeven achter de 'breakafter'-stuurparameter, dan krijgt de stepvar de waarde <div style='clear:both;'></div>.
Is het recordnummer niet deelbaar door de numerieke waarde opgegeven achter 'breakafter', dan is de stepvar leeg.
Door deze parameter te plaatsen als laatste lijn van het stuurgedeelte van een Stepcollect-bronpagina, en door het herhalend gedeelte te omlijst met een html <div>-element, kan het effect worden bekomen van een aantal kolommen na elkaar.
Een kleine tutorial over het html <div>-element.
Een <div>-html element is, net zoals het <SPAN>-html element bedoeld om andere html-elementen t groeperen. Zij moeten dan ook worden afgesloten met hun overeenkomstige </div> en </SPAN>-code.
Zonder bijkomende parameters hebben noch <div>, noch <SPAN> enig effect op de getoonde html-pagina.
Door echter een style-parameter, een class-parameter of een id-parameter te plaatsen achter op het <div>-element te plaatsen, kunnen bepaalde style worden toegepast op alle elementen tussen<DIV> en </div> of kunnen bepaalde formaatinstellingen worden ingesteld (zoals marges, kaders e.d.).
In een style-parameter dienen de stijldefinities opgenomen te worden in het <div>-blok, de class en id parameters zullen een style-naam wwergeven dewelke dan in een externe o interne steylsheet (.css-bestand) dienen aanwezig te zijn.
Voorbeeld van een <DIV>html element
<div style='border:1px solid white;background-color:#004040;margin:5px;padding:3px;font-size:9px;'>
<i><b>Star-Trek: To Boldly Go Where no Website Has Gone Before.</b></i>
Kies:<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'> Deep Space 9 boeken</a>
<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'> New Frontier boeken</a> |
<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'> Next Generation boeken</a> |
<a href='http://www.sitestepper.be/nl/__underconstruction__.htm'> Original Series boeken</a> |
</div>
De html-code die we hebben gebruikt om het Star Trek menu op de webpagina's te creëren was tussen een <div>..</div> geplaatst.
De gebruikte <div> heeft een style-parameter wat betekent dat de stijlen aanwezig zullen zijn als waarde van deze parameter en dat ze dus achter <DIV en voor het eind->-karakter dienen geplaatst te worden..
Ter info
- parameters van html-elementen dien door tenminste één statie gescheiden te zijn van de naam van het html-element.
- De waarde van een parameter dient tussen enkele quotes of dubbele quotes beplaatst te worden. Beide zijn mogelijk zolang maar dezelfde eind-quote wordt gebruikt als het begin-karakter. Indien een parameter een enkele quote dient te bevatten als waarde, kan het best de dubbele quote worden gebruikt als begin- en eindkarakter (en visa versa).
- Indien in de parameter hetzelfde
quote-karakter dient te worden geplaatst als het quote-karakter dat
wordt gebruikt als begin- en eindkarakter, dan dient dit tweemaal
en onmiddellijk na elkaar te worden geplaatst.
Bijvoorbeeld: parameter "Hij zei:""u hebt gelijk""." is een correcte weergave in html van de tekst op de website Hij zei: "u hebt gelijk".
De style-parameter uitgelegd
Stijlen dienen opgegeven te worden gescheiden door ';'-karakter, met telkens een stijlode, gevolgd door een dubbel punt (':') en gevolgd door één of meerdere stijlwaardes – indien meer dan één stijlwaarde aanwezig is voor een bepaalde code, dan dienen deze gescheiden te worden door één of meerdere spaties.
Het voorbeeld:
- border:1px solid white; Tekent een kader rond de inhoud van <div>..</div>, in dit geval dus rond het volledige Star Trek menu. De kader is 1 pixel breed (1px), wordt getekend in een volledige lijn (solid) en heeft de kleur wit (white).
- background-color:#004040; Zal de achtergrond van het volledige <div>..</div>-kader tonen in het donkergroen (#004040 = donkergroen).
- margin:5px;: Zal langs de buitenkant van het kader en langs alle kanten van het kader een marge van 5 pixels plaatsen. Hadden we enkel een marge gewesnt aan één bepaalde kant van de kader, dan hadden we kunnen margin-left, margin-right, margin-top of margin-bottom kunnen gebruiken.
- padding:3px; Zal aan de binnenkant van het kader en langs alle kanten een binnenmarge van 5 pixels plaatsen. M.a.w. de tekst binnen het <DIV<..</div> kader zal 5 pixelsverwijdert zijn van de omringende kader.
- font-size:9px; De tekst binnen de <div>..</div>-element (dus binnen het kader) zal 9 pixels groot zijn (dit in tegenstelling tot de rest van de site die duidelijk een grotere font heeft.
Er zijn verschillende mogelijkheden meer, natuurlijk, om via stylen een website te formatteren en op te bouwen.
Tip
- Op de site van Sitestepper zal een up-to-date boekenlijst worden bijgehouden van interessante boeken op de pagina: http://www.sitestepper.be/nl/boeken.htm (natuurlijk ook een stepcollectie ☺).
Tutorial verschillende kolommen stap 1: broncode met <div>-elementen aanmaken
Zoals steeds zal een voorbeeld veel duidelijk maken.
- Maak een nieuwe pagina onder 'Star Trek collectiepaginas', noem deze 'Star Trek boekenin 2 kolommen', en ken het keyword 'stepcollectie_startrek_2kol' toe. Sitestepper zal automatisch de skeleton toegekend aan 'Star Trek collectiepaginas' overnemen en dus de skeleton 'Star Trek boeken' toekennen aan de nieuwe pagina.
- Editeer de Nederlandstalige bronpagina van deze tak door 'Alt-2' in te drukken (Editeer – NL) of de 'NL' knop rechts in de talenbalk aan te klikken.
- Voer de volgende html-code in:
<html><!-- Created by Edl on computer VINIKIA-LIVING on 02-nov-2006 at 05:36:03. --><!-- This page may only contain text in the BODY section --><body><h1>Star Trek</h1>
Deze pagina geeft een overzicht van alle boeken gebruik makende van
stepcollecties. De lijst wordt getoond in 2 kolommen.<br>Alle <b></b> zijn aanwezig in de lijst.
<!--StepCollect start collection="star-trek" id="st-2kol" linkedkw="stepcollectie_startrek_perreeks"--><div style='width:275px;border:1px solid white;margin:5px;padding:5px;'>
<img src="{StepCollect-Picture}" border="0" height="100"
style='float:right;margin-left:8px;margin-bottom:8px;'>
{StepCollect-RecNr}:<b>{StepCollect-Title}</b><br>
<i>{StepCollect-SubTitle}</i>
<br>{StepCollect-descr}<br><a href='http://www.sitestepper.be/nl/__underconstruction__.htm'>Bekijk alle boeken uit deze serie</a>
<br><br>Code: {StepCollect-Code}</div><!--StepCollect end--></body></html>HTMLcode 38: Gegenereerde Stepcollectie-pagina met <div> in 1 kolom
- In plaats van een html-<table> te gebruiken, wordt nu een <div>..</div> gebruikt. Vermits de <div> de plaats inneemt van de html-td-code, dient deze binnen het stuurgedeelte van StepCollect te worden geplaatst.
- Lijnen 10 en 23 in voorgaande code
definiëren dan ook het element dat zal worden herhaald voor
elk record van de stepcollectie. Het <div>-element wordt 275
pixels breed gemaakt (het is altijd een goede methode om expliciet
een breedte en/of een hoogte van een <div>-box op te geven),
er wordt een dikke witte kader rond getekend, en zowel binnen als
buiten de kader worden een aantal pixels als marge ingesteld.
De breedte van 275 pixels is gekozen om er zeker van te zijn dat twee kolommen naast elkaar kunnen worden getoond. - Bewaar de code (Ctrl-S in StepEdit), switch naar StepGen (F12 in StepEdit) en genereer de StepCollect-pagina: 'Genereer – Genereer Stepcollectpagina's': een nieuwe pagina 'Star Trek boeken in 2 kolommen-automatic' zal worden aangemaakt (vermits we geen expliciete type=-stuurparameter hebben gedefinieerd, wordtd per default de all-waarde genomen, dus worden alle records opgenomen op de pagina, en krijgt de gegenereerde pagina de suffix _automatic).
- Build de gegenereerd pagina (F9 – Genereer geselecteerde pagina).
- Bekijk de gegeneerde pagina: selecteer 'Star Trek boeken in 2 kolommen-automatic' en druk op Ctrl-F8 (View – Toon huidige pagina').
Afbeelding 143 laat zowel een positieve als een negatieve karaktereigenschap van <div>-elementen zien.
Een positieve karaktereigenschap van <div>-elementen is dat deze, zolang ze kunnen, naast elkaar worden geplaatst.
Pas als er geen plaats meer is, wordt het volgende <div>-element onder een voorgaande geplaatst.
Alhoewel dit op het eerst zicht juist de bedoeling is, komt hier ook de negatieve karaktereigenschap vam <div>-elementen op de proppen.
Het zijn de woordjes 'als er geen plaats meer is', die (voor ons doel dan toch) deze methode onbruikbaar maken.
Zoals te zien op voorgaande schermafdruk, kan de browser perfect bepalen dat er nog plaats is om een nieuw <div>-blok te plaatsen, onder één van de voorgaande blokken.
In de schermafdruk is dan ook duidelijk te zien dat boek nr. 5 – dewelke normaal zou moeten komen in de derde links kolom (dus onder boek nr.3), door de browser onder boek nr.4 is geplaatst.
In 99% van de gevallen is dit niet het effect dat gewenst wordt.
Tutorial verschillende kolommen stap 2: broncode uitbreiden met <div 'clear:both'>
Gelukkig is er een oplossing van voorgaande probleem.
Er kan aan de browser een opdracht worden gegeven om het volgende <div>-blok geforceerd te plaatsen onder alle voorgaande <div>-bloks. Dus niet waar er plaats is maar gegarandeert onder de reeds aanwezige blokken.
Deze opdracht kan worden gegeven door het invoegen van de volgende html-code:
<div style="clear:both;"></div>
HTMLcode 39: clear:both tagDe clear:both style-parameter duidt aan dit <div>-blok onder alle reeds voorgaande dient te worden geplaatst.
Wensen we alle <div>-blokken onder elkaar te plaatsen (om zodoende een layout te bereiken van 1 kolom), dan kunnen we dus:
- Ofwel de breedte van de <div>-elementen zo instellen dat er geen twee naast elkaar kunnen (vul in voorgaande voorbeeld maar eens een breedte in van 400px (ipv 275px), regenereer en rebuild de pagina en zie het resultaat: er kunnen geen twee kolommen meer naast elkaar, dus worden alle <div>-blokken onder elkaar getoond.
- Ofwel bovenstaande code onder elke bestaande
<div> blok toevoegen.
Ook als is de breedte van de kolom zo smal dat er perfect twee (of meer) naast elkaar zouden kunnen, toch worden deze allemaal onder elkaar geplaatst.
Tutorial verschillende kolommen stap 3: StepCollect <div 'clear:both'> laten toevoegen
Als er verschillende <div>-blokken naast elkaar dienen geplaatst te worden (om de records van een StepCollectie te tonen in verschillende kolommen), dan kan voorgaande methode niet worden gebruikt.
Er kan, m.a.w., geen expliciete <div style="clear:both;"></div>-lijn aanwezig zijn in het stuurgedeelte van de Stepcollect-pagina (want dan worden alle blokken in 1 kolom en onder elkaar getoond).
StepCollect kan dan ook worden opgedragen de <div style="clear:both;"></div>-lijn zelf toe te voegen aan de gegenereerde pagina, maar niet bij elk record, maar enkel om de x-aantal <div>-blokken.
Pas de voorgaande html-code aan, als aangeduid in de volgende code:
<html><!-- Created by Edl on computer VINIKIA-LIVING on 02-nov-2006 at 05:36:03. --><!-- This page may only contain text in the BODY section --><body><h1>Star Trek</h1>
Deze pagina geeft een overzicht van alle boeken gebruik makende van
stepcollecties. De lijst wordt getoond in 2 kolommen.<br>Alle <b>{st-2kol_count}</b> zijn aanwezig in de lijst.
<!--StepCollect start collection="star-trek" id="st-2kol" linkedkw="stepcollectie_startrek_perreeks" breakafter="2"-->
<div style='width:275px;border:1px solid white;margin:5px;padding:5px;'>
<img src="{StepCollect-Picture}" border="0" height="100"
style='float:right;margin-left:8px;margin-bottom:8px;'>
{StepCollect-RecNr}:<b>{StepCollect-Title}</b><br>
<i>{StepCollect-SubTitle}</i>
<br>{StepCollect-descr}<br><a href='http://www.sitestepper.be/nl/__underconstruction__.htm'>Bekijk alle boeken uit deze serie</a>
<br><br>Code: {StepCollect-Code}</div>{StepCollect-breaktag}<!--StepCollect end--></body></html>
Het breakafter="2" stuurelement geeft, in vorobeeld, aan dat:
- De {StepCollect-breaktag} om de twee records de waarde <div style="clear:both;"></div> dient te bevatten.
- Voor alle andere records zal de {StepCollect-breaktag}-stepvar leeg zijn.
- Door deze stepvar nu te plaatsen ná het reeds aanwezig <div>-blok maar nog steeds in de StepCollect-stuurcode, zal het effect worden bekomen.
- Voor het eerste record is de waarde van leeg, voor de tweede record bevat deze de tekst: <div style="clear:both;"></div>, de derde is weer leeg, de vierde is weer gevuld met <div style="clear:both;"></div>, de vijfde is leeg enzovoort...
- In het algemeen kan worden gesteld: als het recordnummer van de StepCollectie deelbaar is door het getal opgegeven als waarde van het breakafter-stuurelement, dan wordt de stepvar opgevuld met <div style="clear:both;"></div>, in alle andere gevallen is de StepVar leeg.
Zoals in deze afbeelding te zien is, is het
effect nu zoals oorspronkelijk gewenst.
Geavanceerde technieken: een pagina tonen met aanklikbare afbeeldingen
Zonder al te veel uitleg, zal nu nog de code en de gegenereerde pagina worden getoond indien een pagina zou gemaakt wensen te worden met enkel de afbeeldingen van alle Star Trek-boeken aangevuld met de mogelijkheid om op elke afbeelding te klikken naar de correcte rubriek toe.
De html-code:
<html> <!-- Created by Edl on computer VINIKIA-LIVING on 02-nov-2006 at 06:53:03. --> <!-- This page may only contain text in the BODY section --> <body> <h1>Star Trek</h1> Klik de boeken om verder te gaan ... <!--StepCollect start collection="star-trek" id="st-afbeeldingen" linkedkw="stepcollectie_startrek_perreeks"breakafter="5"--> <div style='float:left;text-align:center;width:100px;border:2px solid white;margin:5px;padding:5px;'> <a href='http://www.sitestepper.be/nl/__underconstruction__.htm'><img src="{StepCollect-Picture}" border="0" height="100"></a> </div> {StepCollect-breaktag} <!--StepCollect end--> </body> </html>HTMLcode 41: StepCollect-voorbeeldcode voor een pagina met afbeeldingen
De breakafter="5" geeft aan dat 5 afbeeldingen naast elkaar mogen geplaatst worden.
De {StepCollect-breaktag} zal na elk 5-de record de <div style="clear:both;"></div> code toevoegen.
Tutorials einde
Dit beëindigt de tutorials over StepCollectie.
Er zijn verschillende soorten webpagina's aangemaakt, allemaal startende vanaf een op een zeer gemakkelijke manier ingevoerde set van gegevens, lompleet met doorklikbare afbeeldingen en verwijzingen tussen verschillende pagina;s.
Vermits StepCollect een aantal lijnen aan html-code (of .asp, of .php-code) herhaald voor een (hele) reeks records in een StepCollectie, zonder dat nog naar de html-code dient gekeken te worden. is deze optie uitermate voor het publiceren én onderhouden van webpagina's met massa's gelijke informatie.
Resultaat:
Op elke afbeelding van elk boek kan worden doorgeklikt naar de specifieke webpagina van de aangeklikte serie.
29In een normale installatie is dit: c:\sitestepper\bin.
30Het is in de Windows-omgeving nooit een correcte manier om de pc af te zetten, zonder Windows correct af te sluiten.
31Bij een standaard Sitestepperinstallatie wordt een voorbeeldstepcollectie bijgevoegd van een aantal Star-Trek boeken. Deze kan worden gebruikt om StepCollect uit te proberen.
32De parameter 'selectie' mag worden gebruikt in plaats van de Engelste term 'selection'. Beide hebben exact hetzelfde doel.
33type=all werd niet gespecificeerd op de stuurlijn van de stuurpagina van tutorial step 2, maar type=all is de default waarde die wordt genomen

