diff --git a/index.html b/index.html index 7efc3bf..66504b4 100644 --- a/index.html +++ b/index.html @@ -1 +1,12 @@ -Gebruikershandleiding word2respec

Repository word2werkversie

In de repository word2werkversie is een workflow ingericht waarmee u zelf word-bestanden om kunt zetten naar een respec-werkversies. U heeft hiervoor een lokale kopie van de repository nodig.

De repository klonen

Een handige applicatie voor het beheer van uw GitHub-repositories is GitHub Desktop.

media/image1.png
Toevoegen van een repository
media/image2.png
Zoek repository word2werkversie

Hiermee worden alle benodigde bestanden lokaal opgeslagen. De map word2werkversie/input bevat het sjabloon respec.dotm en het te converteren word-bestand. Er mag maar één docx-bestand in de map staan. Houd er rekening mee dat meer gebruikers de repository gebruiken. Uw word-bestand wordt dan verwijderd.

Een word-bestand pushen

De repository word2werkversie bevat een action dat het gepushte word-bestand omzet naar respec-bestanden en deze plaatst in een GitHub-repository.

media/image3.png
Commit het word-bestand
media/image4.png
Push het word-bestand

Na de push start op de GitHub-repository een action dat de transformatie uitvoert.

media/image5.png
Overzicht van uitgevoerde transformaties
media/image6.png
De nieuwe repository
media/image7.png
De pages-variant

Ondersteunde word-functionaliteit

Koppenstructuur

Alle transformaties in de word2respec-workflow zijn gebaseerd op het gebruik van de stijlen ‘Kop 1’ t/m ‘Kop 9’. Overigens biedt dit veel extra mogelijkheden binnen word. Het venster ‘Stijlen’ opent (en sluit) u met toetscombinatie Alt+Ctrl-Shift+S.

media/image16.png
Navigatie op basis van de koppenstructuur

Opsommingen

Er zijn twee typen opsommingen, genummerd en met tekens. Hiervoor dient u de word-functie ‘Opsommingen’ te gebruiken. De opsommingen mogen gedefinieerd zijn in de stijl. De opsomming wordt omgezet naar opsommingen zoals ze voor het specifieke domein zijn gedefinieerd in het css-bestand. Dus het is mogelijk dat een opsomming met kapitale letters wordt omgezet naar Romeinse cijfers.

Verwijzingen

Omdat de koppenstructuur, figuurnummers en tabelnummers worden gegenereerd door respec, is het niet verstandig om verwijzingen als tekst op te nemen. Dit kan op twee manieren:

Kruisverwijzingen

Hiervoor gebruikt u de word-functie ‘Kruisverwijzing’ (Alt+Ctrl+Shift+K). Hiermee kunt u verwijzen naar alle mogelijke genummerde alinea’s.

media/image17.png
Scherm ‘Kruisverwijzing’
media/image18.png
Weergave van een kruiskoppeling in respec

Hyperlinks

Ook hyperlinks worden doorgegeven in de respec-weergave. Met scherm ‘Hyperlink invoegen’ (Ctrl+K) voegt u een hyperlink toe, bijvoorbeeld naar hoofdstuk Repository word2werkversie.

media/image19.png
Scherm voor het invoegen en bewerken van hyperlinks
media/image20.png
Weergave van een hyperlink in respec

Figuren

Het veiligst is om figuren met tekstomloop ‘In tekstregel’ te gebruiken. De transformatie moet namelijk weten waar in de tekst een figuur ‘verankerd’ is. Dit is in word de standaard-mogelijkheid voor het plaatsen van figuren. De omvang van een figuur wordt berekend aan de hand van de breedte. De verhouding tussen de figuurbreedte en tekstbreedte wordt gebruikt in de uiteindelijke respec-weergave. Als de figuurbreedte meer dan 90% van de tekstbreedte is, wordt het uitgevuld naar de volledige tekstbreedte.

Het is mogelijk om met kruisverwijzingen (zie3.3.1) te verwijzen naar een figuur. De alinea onder de figuur wordt omgezet naar een figuurbijschrift als u het markeert met stijl ‘Figuurbijschrift’ of ‘Bijschrift’.

Tabellen

Tabellen worden volledig door de workflow word2respec ondersteund:

Als u de alinea boven de tabel markeert met stijl ‘Tabeltitel’ of ‘Bijschrift’, dan wordt de alinea verwerkt als tabeltitel. In de tekst kunt u verwijzen naar de tabeltitel (zie3.3.1). Merk op dat respec in de weergave de tabeltitel niet weergeeft met een nummering. Onderstaand is een voorbeeldtekst.

Vergelijking met huidige rechtsfiguren en RO Standaarden

Onderwerp

Specificatie

Vergelijkbaar met / voortzetting van huidige rechtsfiguur

  • bestemmingsplan, uitwerkingsplan, wijzigingsplan en inpassingsplan op basis van Wro

  • beheersverordening op basis van Wro

  • bestemmingsplan met verbrede reikwijdte op basis van Crisis- en herstelwet

  • welstandsnota op basis van Woningwet

  • erfgoedverordening op basis van Monumentenwet

  • algemene plaatselijke verordening op basis van Gemeentewet

  • …

Voortzetting van instrument in RO Standaarden

Ja, bestemmingsplan en beheersverordening

INSPIRE-thema

Planned Land Use: SpatialPlan

Voetnoten

De transformatie ondersteunt niet-complexe voetnoten. Onderstaand is een voorbeeldtekst.

Op grond van artikel 20.26 lid 2 Omgevingswet worden besluiten en andere rechtsfiguren op grond van die wet die bij ministeriële regeling zijn aangeduid als omgevingsdocument, ontsloten via DSO-LV. De bedoelde ministeriële regeling is de Regeling standaarden publicaties Omgevingswet[1] De Regeling standaarden publicaties Omgevingswet is een ministeriële regeling bij de Bekendmakingswet
. Deze regeling wijst besluiten en andere rechtsfiguren aan als omgevingsdocument en stelt het verplicht om die omgevingsdocumenten, en ontwerpen daarvan, elektronisch vorm te geven conform de Standaard voor Officiële Publicaties, het InformatieModel Omgevingswet en het voor het betreffende omgevingsdocument voorgeschreven toepassingsprofiel. Ook bevat deze regeling de verplichting om omgevingsdocumenten voor publicatie aan te bieden aan het Bronhouderkoppelvlak van de LVBB.

media/image21.png
Respec-weergave van een voetnoot

Ondersteunde respec-functionaliteit

In respec-weergave komen tekstsoorten voor waarvoor we een specifieke word-opmaak hebben afgesproken. U kunt deze toevoegen met de opties ‘Tekstsoorten’ en ‘Code’, links in de werkbalk.

Code

Een code-blok wordt in word aangegeven door het hele blok te markeren met menu-optie ‘Code’. Onderstaand is voorbeeldtekst. Let erop dat de inspringing met een tab-teken moet.

<xsl:template match="w14:checkbox">

<xsl:element name="input">

<xsl:attribute name="class" select="string('task-list-item-checkbox')"/>

<xsl:attribute name="id" select="generate-id(.)"/>

<xsl:attribute name="style" select="string('margin-right: 2mm;')"/>

<xsl:attribute name="type" select="string('checkbox')"/>

<xsl:if test="w14:checked/@w14:val=1">

<xsl:attribute name="checked"/>

</xsl:if>

</xsl:element>

</xsl:template>

Code kan ook binnen een alinea staan. Dan is het voldoende om dit gedeelte te markeren met optie ‘Code’.

media/image22.png
Voorbeeld van een code-blok in word

Citaat

Een citaat wordt aangegeven door de alinea te selecteren en optie ‘Tekstsoorten’, ‘Citaat’ te kiezen.

Dit is een voorbeeld van een citaat.

media/image23.png
Voorbeeld van de tekstsoorten ‘Citaat’, ‘Issue’ en ‘Noot’ in word

Issue

In respec is het mogelijk om extra functionaliteit voor issues op te nemen. Zet in de eerste alinea het issue waarnaar gekoppeld moet worden en de titel. Selecteer de tekst en markeer het met ‘Teksoorten’, ‘Issue’.

Issue 22: Invullen van dct:license en dct:rights

dct:license en dct:rights zijn te vinden in resource én in dataservice. Wanneer moet je nu welke eigenschap invullen?

Redactionele noot

Een redactionele noot wordt aangegeven door de alinea te markeren met menu-optie ‘Tekstsoorten’, ‘Noot’. Onderstaand is voorbeeldtekst.

Voor de beschrijving verwijzen we naar de documentatie in de bijlage.

Voorbeeld

Een voorbeeld wordt aangegeven door de alinea te selecteren en optie ‘tekstsoorten’, ‘Voorbeeld’ te kiezen. Het is mogelijk om een code-blok binnen een voorbeeld aan te geven. Onderstaand is voorbeeldtekst.

media/image24.png
Voorbeeld van een voorbeeld in word

Bibliografische referenties

Met menu-optie ‘Document’ tabblad ‘Bibliografie’ (zie2.3.4) in de respec-werkbalk kunt u publicaties opgeven waarnaar u met een bibligrafische referentie kunt verwijzen. Dit kan door de identifier van de publicatie tussen dubbele rechte haken te plaatsen: [[DONL]]. Respec voegt dan een bijlage toe met normatieve of informatieve referenties, afhankelijk van de opgegeven soort informatie (zie2.3.2).

media/image25.png
Bijlage met normatieve referenties
media/image26.png
Als een referentie ontbreekt, geeft respec een foutmelding
\ No newline at end of file +Gebruikershandleiding word2respec

Repository word2werkversie

In de repository word2werkversie is een workflow ingericht waarmee u zelf word-bestanden om kunt zetten naar een respec-werkversies. U heeft hiervoor een lokale kopie van de repository nodig.

De repository klonen

Een handige applicatie voor het beheer van uw GitHub-repositories is GitHub Desktop.

media/image1.png
Toevoegen van een repository
media/image2.png
Zoek repository word2werkversie

Hiermee worden alle benodigde bestanden lokaal opgeslagen. De map word2werkversie/input bevat het sjabloon respec.dotm en het te converteren word-bestand. Er mag maar één docx-bestand in de map staan. Houd er rekening mee dat meer gebruikers de repository gebruiken. Uw word-bestand wordt dan verwijderd.

Een word-bestand pushen

De repository word2werkversie bevat een action dat het gepushte word-bestand omzet naar respec-bestanden en deze plaatst in een GitHub-repository.

media/image3.png
Commit het word-bestand
media/image4.png
Push het word-bestand

Na de push start op de GitHub-repository een action dat de transformatie uitvoert.

media/image5.png
Overzicht van uitgevoerde transformaties
media/image6.png
De nieuwe repository
media/image7.png
De pages-variant

Ondersteunde word-functionaliteit

Koppenstructuur

Alle transformaties in de word2respec-workflow zijn gebaseerd op het gebruik van de stijlen ‘Kop 1’ t/m ‘Kop 9’. Overigens biedt dit veel extra mogelijkheden binnen word. Het venster ‘Stijlen’ opent (en sluit) u met toetscombinatie Alt+Ctrl-Shift+S.

media/image16.png
Navigatie op basis van de koppenstructuur

Opsommingen

Er zijn twee typen opsommingen, genummerd en met tekens. Hiervoor dient u de word-functie ‘Opsommingen’ te gebruiken. De opsommingen mogen gedefinieerd zijn in de stijl. De opsomming wordt omgezet naar opsommingen zoals ze voor het specifieke domein zijn gedefinieerd in het css-bestand. Dus het is mogelijk dat een opsomming met kapitale letters wordt omgezet naar Romeinse cijfers.

Verwijzingen

Omdat de koppenstructuur, figuurnummers en tabelnummers worden gegenereerd door respec, is het niet verstandig om verwijzingen als tekst op te nemen. Dit kan op twee manieren:

Kruisverwijzingen

Hiervoor gebruikt u de word-functie ‘Kruisverwijzing’ (Alt+Ctrl+Shift+K). Hiermee kunt u verwijzen naar alle mogelijke genummerde alinea’s.

media/image17.png
Scherm ‘Kruisverwijzing’
media/image18.png
Weergave van een kruiskoppeling in respec

Hyperlinks

Ook hyperlinks worden doorgegeven in de respec-weergave. Met scherm ‘Hyperlink invoegen’ (Ctrl+K) voegt u een hyperlink toe, bijvoorbeeld naar hoofdstuk Repository word2werkversie.

media/image19.png
Scherm voor het invoegen en bewerken van hyperlinks
media/image20.png
Weergave van een hyperlink in respec

Figuren

Het veiligst is om figuren met tekstomloop ‘In tekstregel’ te gebruiken. De transformatie moet namelijk weten waar in de tekst een figuur ‘verankerd’ is. Dit is in word de standaard-mogelijkheid voor het plaatsen van figuren. De omvang van een figuur wordt berekend aan de hand van de breedte. De verhouding tussen de figuurbreedte en tekstbreedte wordt gebruikt in de uiteindelijke respec-weergave. Als de figuurbreedte meer dan 90% van de tekstbreedte is, wordt het uitgevuld naar de volledige tekstbreedte.

Het is mogelijk om met kruisverwijzingen (zie 3.3.1) te verwijzen naar een figuur. De alinea onder de figuur wordt omgezet naar een figuurbijschrift als u het markeert met stijl ‘Figuurbijschrift’ of ‘Bijschrift’.

Tabellen

Tabellen worden volledig door de workflow word2respec ondersteund:

Als u de alinea boven de tabel markeert met stijl ‘Tabeltitel’ of ‘Bijschrift’, dan wordt de alinea verwerkt als tabeltitel. In de tekst kunt u verwijzen naar de tabeltitel (zie 3.3.1). Merk op dat respec in de weergave de tabeltitel niet weergeeft met een nummering. Onderstaand is een voorbeeldtekst.

Vergelijking met huidige rechtsfiguren en RO Standaarden

Onderwerp

Specificatie

Vergelijkbaar met / voortzetting van huidige rechtsfiguur

  • bestemmingsplan, uitwerkingsplan, wijzigingsplan en inpassingsplan op basis van Wro

  • beheersverordening op basis van Wro

  • bestemmingsplan met verbrede reikwijdte op basis van Crisis- en herstelwet

  • welstandsnota op basis van Woningwet

  • erfgoedverordening op basis van Monumentenwet

  • algemene plaatselijke verordening op basis van Gemeentewet

  • …

Voortzetting van instrument in RO Standaarden

Ja, bestemmingsplan en beheersverordening

INSPIRE-thema

Planned Land Use: SpatialPlan

Voetnoten

De transformatie ondersteunt niet-complexe voetnoten. Onderstaand is een voorbeeldtekst.

Op grond van artikel 20.26 lid 2 Omgevingswet worden besluiten en andere rechtsfiguren op grond van die wet die bij ministeriële regeling zijn aangeduid als omgevingsdocument, ontsloten via DSO-LV. De bedoelde ministeriële regeling is de Regeling standaarden publicaties Omgevingswet[1] De Regeling standaarden publicaties Omgevingswet is een ministeriële regeling bij de Bekendmakingswet
. Deze regeling wijst besluiten en andere rechtsfiguren aan als omgevingsdocument en stelt het verplicht om die omgevingsdocumenten, en ontwerpen daarvan, elektronisch vorm te geven conform de Standaard voor Officiële Publicaties, het InformatieModel Omgevingswet en het voor het betreffende omgevingsdocument voorgeschreven toepassingsprofiel. Ook bevat deze regeling de verplichting om omgevingsdocumenten voor publicatie aan te bieden aan het Bronhouderkoppelvlak van de LVBB.

media/image21.png
Respec-weergave van een voetnoot

Ondersteunde respec-functionaliteit

In respec-weergave komen tekstsoorten voor waarvoor we een specifieke word-opmaak hebben afgesproken. U kunt deze toevoegen met de opties ‘Tekstsoorten’ en ‘Code’, links in de werkbalk.

Code

Een code-blok wordt in word aangegeven door het hele blok te markeren met menu-optie ‘Code’. Onderstaand is voorbeeldtekst. Let erop dat de inspringing met een tab-teken moet.

<xsl:template match="w14:checkbox">
+    <xsl:element name="input">
+        <xsl:attribute name="class" select="string('task-list-item-checkbox')"/>
+        <xsl:attribute name="id" select="generate-id(.)"/>
+        <xsl:attribute name="style" select="string('margin-right: 2mm;')"/>
+        <xsl:attribute name="type" select="string('checkbox')"/>
+        <xsl:if test="w14:checked/@w14:val=1">
+            <xsl:attribute name="checked"/>
+        </xsl:if>
+    </xsl:element>
+</xsl:template>
+

Code kan ook binnen een alinea staan. Dan is het voldoende om dit gedeelte te markeren met optie ‘Code’.

media/image22.png
Voorbeeld van een code-blok in word

Citaat

Een citaat wordt aangegeven door de alinea te selecteren en optie ‘Tekstsoorten’, ‘Citaat’ te kiezen.

Dit is een voorbeeld van een citaat.

media/image23.png
Weergave van tekstsoorten ‘Citaat’, ‘Issue’ en ‘Noot’ in word

Issue

In respec is het mogelijk om extra functionaliteit voor issues op te nemen. Zet in de eerste alinea het issue waarnaar gekoppeld moet worden en de titel. Selecteer de tekst en markeer het met ‘Teksoorten’, ‘Issue’.

Redactionele noot

Een redactionele noot wordt aangegeven door de alinea te markeren met menu-optie ‘Tekstsoorten’, ‘Noot’. Onderstaand is voorbeeldtekst.

Voorbeeld

Een voorbeeld wordt aangegeven door de alinea te selecteren en optie ‘tekstsoorten’, ‘Voorbeeld’ te kiezen. Het is mogelijk om een code-blok binnen een voorbeeld aan te geven. Onderstaand is voorbeeldtekst.

media/image24.png
Voorbeeld van een voorbeeld in word

Bibliografische referenties

Met menu-optie ‘Document’ tabblad ‘Bibliografie’ (zie 2.3.4) in de respec-werkbalk kunt u publicaties opgeven waarnaar u met een bibligrafische referentie kunt verwijzen. Dit kan door de identifier van de publicatie tussen dubbele rechte haken te plaatsen: [[DONL]]. Respec voegt dan een bijlage toe met normatieve of informatieve referenties, afhankelijk van de opgegeven soort informatie (zie 2.3.2).

media/image25.png
Bijlage met normatieve referenties
media/image26.png
Als een referentie ontbreekt, geeft respec een foutmelding
\ No newline at end of file diff --git a/media/image22.png b/media/image22.png index 61596a4..765b6ef 100644 Binary files a/media/image22.png and b/media/image22.png differ diff --git a/media/image23.png b/media/image23.png index 065b790..1daf119 100644 Binary files a/media/image23.png and b/media/image23.png differ diff --git a/media/image7.png b/media/image7.png index 1cefd87..4b8a3e0 100644 Binary files a/media/image7.png and b/media/image7.png differ