Rst2HTML het omgezette resultaat
Laden en opslaan
Een enkele keer is het nodig om de HTML die bij het omzetten van de restructured text source gegenereerd wordt nog een beetje aan te passen. Dat is waar de load html knop voor bedoeld is (hij is inmiddels ook instrumenteel geworden voor het overzetten naar mirror).
Ik had dit nodig omdat de manier waarop pagina titels in rst gegenereerd worden zich niet helemaal verdraagt met de grid directives die ik gemaakt heb.
Ook hier kun je na het aanbrengen van de wijzigingen met een preview controleren hoe het eruit ziet (de render knop):
En ook hier kun je terug naar het editor scherm met een tijdelijke "back"-button:
Als je er tevreden over bent, kun je het opslaan zodat het niet verloren gaat - hoewel je het opnieuw moet doen als je de rest source opnieuw omzet. Dat is het nadeel van op deze manier wijzigingen aanbrengen, het is ook alleen bedoeld voor kleine correcties en ik gebruik het tegenwoordig eigenlijk nauwelijks meer.
Migreren naar mirror
De volgende knop is de functie om de HTML over te zetten naar een omgeving die gebruikt kan worden als een preview van de complete site, met werkende links. Van hieruit kunnen de documenten ook gekopieerd worden naar de werkelijke website.
Verwijderingen doorvoeren
Een soortgelijke functie is beschikbaar voor het "overzetten" van verwijderingen.
Anders dan "copy to mirror" werkt deze functie niet per document (omdat verwijderde documenten niet geselecteerd kunnen worden) maar voor alles dat nog verwerkt moet worden. Hij kan bestuurd worden om te kijken wat er nog moet gebeuren dan wel om het daadwerkelijk uit te voeren; en om het uit voeren van source naar target dan wel van target naar mirror.
In het navolgende fragment van een voortgangsoverzicht is het resultaat van een verwijdering in de source omgeving te zien:
De uitlijst functie laat het als volgt zien (sorry voor het verschil in documentnamen, de screenshots zijn op verschillende momenten gemaakt):
De doorvoer functie:
Het resultaat van het doorvoeren laat zien dat de verwijdering nu in de target omgeving zit:
De uitlijst functie laat het als volgt zien:
De doorvoer functie:
Het resultaat laat zien dat het document niet meer bestaat in alle omgevingen:
Beveiliging op soort omzettingen
Bij gebruik van een van de save knoppen (save (settings), convert & show, save converted, save html, copy to mirror) wordt gecontroleerd wat voor source er in het tekstveld staat zodat je niet per ongeluk iets overschrijft met het verkeerde. Daardoor is zoals eerder aangegeven het laden van de HTML ook nodig voor het overzetten naar de mirror site. Je krijgt een waarschuwing als je dat vergeet.