openjade-1.4devel - Online in de cloud

PROGRAMMA:

NAAM

openjade - pas een DSSSL-stylesheet toe op een SGML- of XML-document

KORTE INHOUD

openjade [-vCegG2s] [-b codering] [-f fout_bestand] [-c catalogus_sysid] [-D dir]
[-a link_type] [-A boog] [-E max_fouten] [-i entiteit] [-w waarschuwingstype]
[-d dsssl_spec] [-V variabele[=waarde,-t uitvoertype] [-o uitvoer_bestand]
[sysid​

PRODUCTBESCHRIJVING

openjade is een implementatie van de ISO/IEC 10179:1996-standaard DSSSL-taal. De
De DSSSL-engine ontvangt als invoer een SGML- of XML-document en zet dit om in formaten
graag willen:

* XML-weergave van de stroomobjectboom.

* RTF-formaat dat kan worden weergegeven en afgedrukt met de gratis Word Viewer 97 van Microsoft

* TeX-formaat

* MIF-formaat dat kan worden weergegeven en afgedrukt met Framemaker

* SGML- of XML-formaat. Dit wordt gebruikt in combinatie met niet-standaard stroomobjectklassen
SGML genereren, waardoor dit mogelijk wordt openjade te gebruiken voor SGML/XML-transformaties.

De systeemidentificatie van het te verwerken document wordt als argument opgegeven
openjade. Als dit wordt weggelaten, wordt standaardinvoer gelezen.

openjade bepaalt de systeem-ID voor de DSSSL-specificatie als volgt:

1. Als de optie -d is opgegeven, wordt het argument gebruikt als systeemidentificatie.

2. Anders zoekt het naar verwerkingsinstructies in de proloog van het document. Twee
soorten verwerkingsinstructie worden herkend:



De systeemgegevens van de verwerkingsinstructie worden geparseerd als een SGML-starttag. Het zal zijn
ontleed met behulp van de referentiebetonsyntaxis, ongeacht de daadwerkelijke betonsyntaxis van de
document. De naam waarmee de verwerkingsinstructie begint, kan een stylesheet zijn,
xml-stylesheet of xml:stylesheet. De verwerkingsinstructie wordt genegeerd, tenzij de
waarde van het type attribuut is een van text/dsssl, text/x-dsssl, application/dsssl, of
applicatie/x-dsssl. De waarde van het href-attribuut is de systeemidentificatie van de DSSSL
specificatie.



De systeemidentificatie is het deel van de systeemgegevens van de verwerkingsinstructie
gevolgd door de initiële naam en eventuele witruimte.

Hoewel de verwerkingsinstructie alleen in de proloog wordt herkend, hoeft deze niet in de proloog voor te komen
de documententiteit. Het kan bijvoorbeeld voorkomen bij een DTD. De systeem-ID zal zijn
geïnterpreteerd ten opzichte van waar de verwerkingsinstructie plaatsvindt.

3. Anders wordt de systeemidentificatie van het document gebruikt, waarbij de extensie is gewijzigd
naar .dsl.

Een DSSSL-specificatiedocument kan meer dan één stijlspecificatie bevatten. Als de
systeem-ID van de DSSSL-specificatie wordt dan gevolgd door #id openjade zal gebruiken
de stijlspecificatie waarvan de unieke identificatie id is. Dit is toegestaan ​​zowel bij de -d
optie en met de verwerkingsinstructies.

De DSSSL-specificatie moet een SGML-document zijn dat voldoet aan de DSSSL-architectuur. Voor
een voorbeeld, zie dsssl/demo.dsl.

openjade ondersteunt de volgende opties naast de normale OpenSP (zie onsgmls(1))
opties (merk op dat alle opties hoofdlettergevoelig zijn, dwz -g en -G zijn verschillende opties):

-d dsssl_spec
Dit specificeert dat dsssl_spec de systeemidentificatie is van de DSSSL-specificatie
om gebruikt te worden.

-G Debug-modus. Wanneer er een fout optreedt bij de evaluatie van een uitdrukking, openjade wil
een stacktrace weergeven. Houd er rekening mee dat hierdoor de tail-call-optimalisatie wordt uitgeschakeld.

-c bestandsnaam
De argumenten voor de bestandsnaam specificeren catalogusbestanden in plaats van de documententiteit. De
documententiteit wordt gespecificeerd door de eerste DOCUMENT-invoer in de catalogusbestanden.

-s Strikte nalevingsmodus. Momenteel is het enige effect dat jade er geen gebruikt
vooraf gedefinieerde tekennamen, sdata-entiteitstoewijzingen of naamtekens. Dit is
handig om te controleren of uw stylesheet overdraagbaar is naar andere DSSSL-implementaties
en dat het strikt voldoet aan de DSSSL-specificaties.

-t uitvoertype
uitvoertype specificeert het type uitvoer als volgt:

fot Een XML-weergave van de stroomobjectboom

rtf rtf-95 RTF (gebruikt voor SGML/XML naar RTF-transformaties) Microsoft's Rich Text
Formaat. rtf-95 produceert uitvoer die is geoptimaliseerd voor Word 95 in plaats van Word 97.

tex TeX (gebruikt voor SGML/XML naar TeX-transformaties)

sgml sgml-rauw SGML (gebruikt voor SGML/XML naar SGML-transformaties). sgml-raw niet
regeleinden in tags uitzenden.

xml xml-rauw XML (gebruikt voor SGML/XML naar XML-transformaties). xml-raw zendt niet uit
regeleinden in tags.

html HTML (gebruikt voor SGML/XML naar HTML-transformaties)

mif MIF (gebruikt voor SGML/XML naar MIF-transformaties)

-o uitvoer_bestand
Schrijf uitvoer naar uitvoer_bestand in plaats van de standaard. De standaard bestandsnaam is
naam van het laatste invoerbestand waarvan de extensie is vervangen door de naam van het type
uitgang. Als er geen invoerbestandsnaam is, wordt de extensie toegevoegd aan jade-out.

-V variabele
Dit is gelijk aan doen (definieer variabele #t), behalve dat deze definitie dat wel doet
prioriteit hebben boven elke definitie van een variabele in een stylesheet.

-V variabele=waarde
Dit staat gelijk aan doen (definieer variabele "waarde") behalve dat deze definitie
heeft voorrang op elke definitie van een variabele in een stylesheet.

-V (definiëren variabele waarde)
Dit is gelijk aan doen (variabelewaarde definiëren), behalve deze definitie
heeft voorrang op elke definitie van een variabele in een stylesheet. Merk op dat jij
zal waarschijnlijk een ontsnappingsmechanisme voor de ruimtes moeten gebruiken om het geheel te krijgen
schema-expressie geparseerd als één cmdline-argument.

-w type dan: Controle waarschuwingen en fouten. Meerdere -w opties zijn toegestaan. De volgende waarden
van het type waarschuwingen inschakelen:

xml Waarschuw voor constructies die niet zijn toegestaan ​​door XML.

gemengd Waarschuw voor mixed content modellen die #pcdata nergens toestaan.

sgmldecl Waarschuw voor verschillende dubieuze constructies in de SGML-aangifte.

moet Waarschuwen voor verschillende aanbevelingen in ISO 8879 die het document doet
niet naleven. (Aanbevelingen worden uitgedrukt met ``moeten'', in tegenstelling tot
vereisten die gewoonlijk worden uitgedrukt met ``zal''.)

verzuim Waarschuw voor standaardreferenties.

duplicaat Waarschuw voor dubbele entiteitsverklaringen.

onbepaald Waarschuw voor ongedefinieerde elementen: elementen die in de DTD worden gebruikt maar niet zijn gedefinieerd.

niet gesloten Waarschuw voor niet-gesloten start- en eindtags.

leeg Waarschuw voor lege begin- en eindtags.

net Waarschuw voor net-enable start-tags en null-end-tags.

min-tag Waarschuw voor geminimaliseerde start- en eindtags. Gelijk aan combinatie van
niet-gesloten, lege en netto-waarschuwingen.

ongebruikte-kaart Waarschuw voor ongebruikte korte referentiekaarten: kaarten die zijn gedeclareerd met een
korte referentietoewijzingsdeclaratie, maar nooit gebruikt bij een kort referentiegebruik
aangifte in de DTD.

ongebruikte parameter Waarschuw voor parameter entiteiten die zijn gedefinieerd maar niet worden gebruikt in een DTD.
Ongebruikte interne parameter entiteiten waarvan de tekst INCLUDE of IGNORE is, krijgen de
waarschuwing.

notatie-sysid Waarschuw voor notaties waarvoor geen systeem-ID kan bestaan
gegenereerd.

allen Waarschuw voor omstandigheden die normaal gesproken moeten worden vermeden (naar de mening van de
auteur). Gelijk aan: gemengd, moet, standaard, niet gedefinieerd, sgmldecl, ongebruikte kaart,
ongebruikt-param, leeg en niet gesloten.

Een waarschuwing kan worden uitgeschakeld door de naam te gebruiken met het voorvoegsel no-. Dus -muur
-wno-duplicaat schakelt alle waarschuwingen in behalve die over dubbele entiteit
verklaringen.

De volgende waarden voor waarschuwingstype fouten uitschakelen:

geen-idref Geef geen fout voor een ID-referentiewaarde die geen enkel element als zijn . heeft
ID KAART. Het effect zal zijn alsof elk attribuut dat als ID-referentiewaarde is gedeclareerd, dit had
als naam verklaard.

geen significante Geef geen fout als een teken dat niet significant is
karakter in de referentie concrete syntaxis komt voor in een letterlijke in de SGML
verklaring. Dit kan handig zijn in combinatie met bepaalde buggy-testsuites.

niet geldig Vereist niet dat het document typegeldig is. Dit heeft het effect van
het wijzigen van de SGML-declaratie om VALIDITY NOASSERT en IMPLYDEF ATTLIST YES op te geven
ELEMENT JA. Een optie van -geldig heeft tot gevolg dat de SGML-aangifte wordt gewijzigd
om VALIDITY TYPE en IMPLYDEF ATTLIST NO ELEMENT NO te specificeren. Als geen van beide -geldig noch
-wno-geldig zijn gespecificeerd, daarna de VALIDITY en IMPLYDEF gespecificeerd in de SGML
aangifte zal worden gebruikt.

MILIEU

OpenJade negeert de omgevingsvariabelen SP_CHARSET_FIXED en SP_SYSTEM_CHARSET en
gebruikt altijd Unicode als interne tekenset, alsof SP_CHARSET_FIXED 1 en was
SP_SYSTEM_CHARSET is uitgeschakeld. Alleen de omgevingsvariabele SP_ENCODING is dus relevant
OpenJade's omgang met tekensets.

OPENJADE EXTENSIONS

De volgende externe procedures zijn beschikbaar. Deze externe procedures worden gedefinieerd door
een prototype op dezelfde manier als in de standaard. Om een ​​van deze externe te gebruiken
procedures, moet u gebruik maken van de standaardprocedure voor externe procedures, waarbij u gebruik maakt van een openbare procedure
ID van "UNREGISTERED::James Clark//Procedure::name" waarbij naam de opgegeven naam is
hier, meestal door het volgende op te nemen in de DSSSL-specificatie:

(definieer naam (externe procedure "UNREGISTERED::James Clark//Procedure::name"))

Houd er rekening mee dat de externe procedure #f retourneert als deze niets weet over het opgegeven publiek
identificatie. U kunt dit gebruiken om ervoor te zorgen dat uw DSSSL-specificaties correct werken
andere implementaties die deze extensies niet ondersteunen.

Voor externe procedures die door het OpenJade-team zijn toegevoegd, gebruikt u een openbare identificatie van het formulier
"ONGEREGISTREERD::OpenJade//Procedure::naam".

Een gemakkelijke manier om toegang te krijgen tot alle externe procedures is door gebruik te maken van de stijlspecificatie
dsssl/extensions.dsl#procedures. Het bestand dsssl/extensions.dsl bevat ook stijl
specificaties die de niet-standaard stroomobjectklassen maken en overerven
kenmerken die op een handige manier worden ondersteund door de backends.

Debugging

(foutopsporing obj)

Genereert een bericht met de waarde van obj en retourneert vervolgens obj.

Eenvoudige paginavolgorde koptekst / voettekst onder controle te houden

(if-eerste pagina sosofo1 sosofo2)

Dit kan alleen worden gebruikt bij de specificatie van de waarde van een van de kop-/voetteksten
kenmerken van een eenvoudige paginavolgorde. Het retourneert een sosofo die wordt weergegeven als sosofo1
als de pagina de eerste pagina is van de eenvoudige paginareeks en anders zoals sosofo2.

(if-voorpagina sosofo1 sosofo2)

Dit kan alleen worden gebruikt bij de specificatie van de waarde van een van de kop-/voetteksten
kenmerken van een eenvoudige paginavolgorde. Het retourneert een sosofo die wordt weergegeven als sosofo1
als de pagina een voorpagina is (dwz recto, oneven genummerde) en als sosofo2 als het een achterkant is (dwz
verso, even genummerde) pagina.

nummering

(alle-element-nummer)

(all-element-nummer osnl)

Dit is hetzelfde als elementnummer, behalve dat het elementen telt met een generieke identificatie.
Als osnl geen element is, retourneert #f, anders wordt 1 plus het aantal elementen geretourneerd
begon vóór osnl. Dit biedt een efficiënte manier om een ​​unieke identificatiecode te creëren
elk element in een document.

Extern entiteit toegang

(lees-entiteitsreeks)

Dit retourneert een tekenreeks met de inhoud van de externe entiteit met systeem
identificatiereeks. Dit mag alleen worden gebruikt voor tekstuele entiteiten (CDATA en SDATA), en
niet voor binaire entiteiten (NDATA).

POSIX lokaal toegang

(taal lang land)

Deze procedure retourneert een object van het type taal, als het systeem het opgegeven ondersteunt
taal. lang is een tekenreeks of symbool dat de tweeletterige taalcode geeft. land is een
tekenreeks of symbool dat de tweeletterige landcode aangeeft.

Deze procedure maakt gebruik van POSIX-landinstellingen. Het is een OpenJade-toevoeging. Het wordt niet door iedereen ondersteund
besturingssystemen.

Extended standaard procedures

(sgml-parse sysid #!key actief: ouder: architectuur :)

Hiermee kunt u een SGML-architectuur specificeren ten opzichte waarvan het document moet zijn
worden ontleed. Het is een OpenJade-toevoeging.

(expt qk)

Hiermee kun je een grootheid verheffen tot een integrale macht. Het is een OpenJade-toevoeging.

Beperkingen

In deze sectie worden de beperkingen van de front-end (de algemene DSSSL
motor); elke backend heeft ook zijn eigen beperkingen.

openjade staat geen interne definities toe aan het begin van lichamen en de (test =>
ontvanger) variant van voorwaardeclausules.

openjade ondersteunt slechts één vast bosplan dat de volgende modules omvat:

* basisabs

*prlgabs0

*prlgabs1

* insteekt

* basesds0

* instsds0

* subdcabs

Het implementeert de volgende delen van SDQL niet: HyTime-ondersteuning, aanvullende parsering, knooppunt
normale uitdrukkingen.

Zoekregels, sosofo-synchronisatie, indirecte sosofos, referentiewaarden, decoratiegebieden
en lettertype-eigenschappen worden niet ondersteund.

Houd er rekening mee dat alleen kenmerken worden overgenomen die van toepassing zijn op een bepaald ondersteund stroomobject
kan worden opgegeven.

Karakter/glyph behandeling

Het ondersteunt slechts een enkel vooraf gedefinieerd karakterrepertoire. Een tekennaam van het formulier
U-XXXX waarbij XXXX vier hexadecimale cijfers in hoofdletters zijn, wordt herkend als een verwijzing naar
het Unicode-teken met die code. Voor veel karakters is het ook mogelijk om de
ISO/IEC 10646-naam in kleine letters, met woorden gescheiden door koppeltekens.

Enkele algemene SDATA-entiteitsnamen uit de ISO-entiteitssets worden herkend en toegewezen
karakters. Daarnaast een SDATA-entiteitsnaam van de vorm U-XXXX, waarbij XXXX vier is
hexadecimale cijfers in hoofdletters, wordt toegewezen aan het Unicode-teken met die code.

OpenJade ondersteunt nu de standaard-chars, map-sdata-entity, add-name-chars,
add-separator-chars en char-repertoire declaratie-elementvormen, waardoor een stylesheet mogelijk is
om extra tekennamen, sdata-entiteitstoewijzingen, naamtekens (bijv
toegestane tekens in ID's) en scheidingstekens. Momenteel de enige erkende
karakterrepertoire is het ingebouwde repertoire. Het heeft de openbare identificatie
"ONGEREGISTREERD::OpenJade//Karakterrepertoire::OpenJade".

Validatie

Een aantal zaken die wenselijk zijn om te laten controleren, worden niet gecontroleerd:

* Wanneer de toegestane waarde van een overgeërfd kenmerk een symbool is, controleert OpenJade alleen
dat de waarde een symbool is dat is toegestaan ​​als de waarde van een bepaald kenmerk; #t en #f
worden in dit geval als een speciaal soort symbool behandeld.

* OpenJade controleert niet of een flowobject voorkomt in de context waarin het zich bevindt
toegestaan.

* OpenJade verhindert niet dat stroomobjecten aan de hoofdpoort van een stroom worden bevestigd
object wanneer het stroomobject geen hoofdpoort mag hebben.

* De meeste typecontroles worden uitgevoerd tijdens runtime en niet tijdens het compileren.

* OpenJade controleert niet op niet-erfelijke kenmerken die vereist zijn
gespecificeerd.

* Er wordt niet gecontroleerd of optionele functies die zijn gebruikt, zijn gedeclareerd in de
kenmerken vormen.

Overige beperkingen

De volgende primitieven zijn slechts stompjes:

char-script-case Geeft altijd het laatste argument terug.

adres bezocht? Geeft altijd #f terug.

Voorbeelden

Gegeven een SGML-bestand bestand.sgml, gebruik het stijlblad bestand.dsl en publiceer als een RTF-bestand.

openjade -t rtf-bestand.sgml

Een ander stylesheet gebruiken:

openjade -t rtf -d docbook.dsl bestand.sgml

De print stijlspecificatie in het stylesheet

openjade -t rtf -d docbook.dsl#afdrukbestand.sgml

En gebruik de html-specificatie in het stylesheet om naar html te converteren

openjade -t sgml -i html -d docbook.dsl#html bestand.sgml

Gebruik openjade-1.4devel online met behulp van onworks.net-services