<?DocuGenCtrl-www.vishia.org version="1.0" encoding="ISO-8859-1" ?>
[?Dokumentengenerierung vishia-XmlDocu, alle Html-Files. ?]
genCtrl: XmlDocuGen.genctrl;
importXsl
( XmlDocu_xsl:TopicXhtml.xsl
);
target: ../html/*.*.html := file2Html
( srcpath="../../ZBNF/sf/ZBNF/Xml_Toolbase"
, XmlDocu_xsl/AsciiTopics.zbnf
, XmlDocu_xsl/copy.xsl
, XmlDocu_xsl/Data3Struct2ihcpp.xslp
, XmlDocu_xsl/DocuGenCtrl.zbnf
, XmlDocu_xsl/DocuGenCtrl2Ant.xslp
, XmlDocu_xsl/DocuGenCtrl2Xsl.xslp
, XmlDocu_xsl/DocuGenStd.ant.xml
, XmlDocu_xsl/HtmlFormatStd.xml
, XmlDocu_xsl/Pre2Word.xsl
, XmlDocu_xsl/Pre2Xhtml.xsl
, XmlDocu_xsl/RequCrossRef.xslp
, XmlDocu_xsl/TopicXhtml.xsl
, XmlDocu_xsl/WordFormatStd.xml
, XmlDocu_xsl/XmiDocu.xslp
, XmlDocu_xsl/XmiSample.xsl
);
target: ../html/XmlDocu/docuSrc/*.*.html := file2Html
( XmlDocuGen.genctrl
);
target: ../tmp/*.*.xml := TextTopic2Xml
( DocuGenCtrl.topic
, DocuGenCtrl_internal.topic
, CHeader.topic
, Href.topic
, Pre2Word.topic
, Style.topic
, Topics.topic
, UmlDocu.topic
, WikiFormat.topic
, XhtmlPre.topic
, Xhtml.topic
, XmlDocuGen.topic
);
//prepXml: DocuGenCtrl.topic ->TextTopic2Xml;
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - Dokumentationsgenerierung mit XML" ident=XmlDocuGen
{
input: ../tmp/XmlDocuGen.topic.xml;
input: ./xmlDocuGen.ImgMap.xml;
chapter "Übersicht" (id=XmlDocuGen_Overview)
{ //picture("Übersicht Ablauf der Dokumentengenerierung":"../../Publications/schorrig_XML_DocuGen_1.jpg",
usemap=XML_DocuGen_1);
picture("Übersicht Ablauf der Dokumentengenerierung", imgMap="XMLDocuGen");
topic(XmlDocuGen/overviewNavigation/*, ulStyle="list-closely");
}
chapter "Motivation" (id=XmlDocuGen_conceptualFormulation)
{ topic(XmlDocuGen/conceptualFormulation/*, ulStyle="list-closely", pStyle="standard", style:test1->"test2");
}
chapter "Was braucht man - download" (id=XmlDocuGen_toolbase)
{ topictree(XmlDocuGen/toolbase/*, ulStyle="list-closely", pStyle="standard");
}
chapter "Begriffe" (id=XmlDocuGen_terms)
{ topic(XmlDocuGen/terms/*, ulStyle="list-wide", pStyle="standard");
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "Steuerung der Dokumentengenerierung" ident=DocuGenCtrl
{ input: ../tmp/DocuGenCtrl.topic.xml;
input: ../tmp/DocuGenCtrl_internal.topic.xml;
//input: ./DocuGenCtrl.ImgMap.xml;
topic(XmlDocuGenCtrl/overview);
topic(XmlDocuGenCtrl/DataFlow);
topictree(XmlDocuGenCtrl/Syntax);
chapter "Beschreibung der Arbeitsweise der Konvertierung"
{ p "Dieses Kapitel ist gedacht nicht für die einfache Anwendung sondern zur Darstellung
der internen Wirkungsweise. "
picture("../InclFiles/DocuGenCtrl_internal.png" : "Dokumentengenerierung intern");
topic(XmlDocuGenCtrl/internalOverview/*);
topictree(XmlDocuGenCtrl/DocuGenCtrl2Ant_xslp);
topictree(XmlDocuGenCtrl/DocuGenCtrl2Xsl_xslp);
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - XML-Texttopics" ident=Topics
{
input: ../tmp/Topics.topic.xml;
chapter "Dokumenteninhalte in Topics erfassen"
{
topictree(Topics/*, ulStyle="list-closely");
}
chapter "Aufbau eines XML-Files mit Topics"
{ topictree(TopicsXml/*, ulStyle="list-closely", tableStyle="table-standard");
}
chapter "Topics pflegen in reinen Textfiles" (id=TopicsPOT)
{ topictree(TextTopicsPOT/*, ulStyle="list-closely", tableStyle="table-standard");
}
chapter "Styleangaben zur Formatierung von Topics"
{ topictree(XmlDocuGen-Style/*, ulStyle="list-closely", tableStyle="table-standard");
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - WikiFormat" ident=WikiFormat
{
input: ../tmp/WikiFormat.topic.xml;
input: ../tmp/Xhtml.topic.xml;
chapter "Formatierung von flachen Texten wie bei Wikipedia"
{
//topictree(WikiFormat/concept, ulStyle="list-wide");
//topictree(WikiFormat/inlineFormating, ulStyle="list-wide");
//topictree(WikiFormat/paraFormating, ulStyle="list-wide");
topic(WikiFormat/concept);
chapter "Formatierung in XHTML versus Wikipedia-Formatierung"
{ topic(Xhtml/Usage/*);
topic(WikiFormat/WikiVsXhtml/*);
}
topictree(WikiFormat/inlineFormating);
topictree(WikiFormat/paraFormating);
topictree(WikiFormat/table);
topictree(WikiFormat/link);
topictree(WikiFormat/Image);
topictree(WikiFormat/style);
topictree(WikiFormat/links);
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - Formatierung der Texterscheinung (Style)" ident=Style
{ input: ../tmp/Style.topic.xml;
chapter "Indirekte Formatierung bei HTML (CSS) und word" (id=XhtmlStyle)
{ topictree(XmlDocuGen-Style/IndirectStyle, ulStyle="list-closely");
topictree(XmlDocuGen-Style/format, ulStyle="list-closely");
}
chapter "Style-Verarbeitung bei TextTopics" (id=XhtmlStyleTopic)
{ topictree(XmlDocuGen-Style/topicStyle, ulStyle="list-closely");
topictree(XmlDocuGen-Style/format, ulStyle="list-closely");
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - Dokumentation aus Headerfiles" ident=HeaderDocu
{ input: ../tmp/CHeader.topic.xml;
input: ../tmp/UmlDocu.topic.xml;
input: XmlDocuGen.ImgMap.xml;
//input: ../tmp/StateofCompletion.topic.xml;
chapter "Einbinden von Headerfiles in einer Dokumentation"
{ topictree(CHeader/HeaderDocu/*);
}
chapter "Beispiel für eine erzeugte Dokumentation"
{ picture("Ablauf Dokumentengenerierung mit Headerfile", imgMap="HeaderDocu");
topictree(CHeader/ImageHeaderDocu/*);
topictree(CHeader/CHeaderDocuSample_ObjectJc/*);
}
chapter "Aufbau eines Headerfiles tauglich für Dokumentationsgenerierung"
{ topictree(CHeader/TextStructureHeader/*);
}
chapter "Gestaltung der Dokumentation einzelner Ausschnitte aus dem Headerfile"
{ chapter "Darstellung von Strukturen"
{ topictree(CHeader/ShowStruct/*);
}
chapter "Strukturen mit zugehörigen Funktionsprototypen als OO-class auffassen"
{ topictree(CHeader/StructUmlClass/*);
topictree(UmlDocu/umlClass/*);
}
chapter "Werte aus enum und define"
{ p "TODO"
topictree(XmlDocuGen/StateofCompletion/todoXsl/*);
}
chapter "define-Konstrukte auch mit bedingter Compilierung"
{ p "TODO"
}
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - Dokumentation aus UML-Modellen" ident=UmlDocu
{ input: ../tmp/XmlDocuGen.topic.xml;
input: ../tmp/UmlDocu.topic.xml;
//input: StateofCompletion.topic.txt;
chapter "Einbinden von Teilen aus UML-Entwürfen in einer Dokumentation"
{ topictree(UmlDocu/UmlInDocument/*);
}
topictree(UmlDocu/General_SelectFromUml);
topictree(UmlDocu/SelectFromUml);
topictree(XmlDocuGen/StateOfCompletion/todoXsl);
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - Querverweise in generierter Dokumentation" ident=Hyperlink
{ input: ../tmp/Href.topic.xml;
chapter "Querverweise"
{ topictree(XmlDocuGen/href);
}
chapter "Korrektur von Hyperlinks im Verlauf der Dokumentengenerierung" (id=CorrectHref)
{ p "TODO"
p "siehe vishia/xml/CorrectHref.java"
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - Das Format XhtmlPre" ident=XhtmlPre
{ //input: XmlDocuGen.topic.txt;
input: ../tmp/XhtmlPre.topic.xml;
chapter "XhtmlPre"
{ topictree(XmlDocuGen/XhtmlPre/*);
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - Erzeugung von HTML und XHTML" ident=Pre2Xhtml
{ input: ../tmp/XmlDocuGen.topic.xml;
chapter "TODO"
{ p "TODO "
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
Document "vishia - Erzeugung von Word.xml" ident=Pre2Word
{ input: ../tmp/XmlDocuGen.topic.xml;
chapter "TODO"
{ p "TODO "
}
}
//**************************************************************************************************
//**************************************************************************************************
//**************************************************************************************************
//Links innerhalb von den vishia-Seiten, Ausganspunkt ist immer ein Verzeichnis unterhalb html.
HyperlinkAssociation
{
//Verweise auf andere Dokumente innerhalb der XmlDocuGen:
//-------------------------------------------------------
//ConverterWikistyleTextToXml ="../Xml/ConverterWikistyleTextToXml.html";
XmlDocuGen-Overview = "XmlDocuGen.html";
ConverterWikistyleTextToXml ="../../Java/docuSrcJavaPublic/vishia/xml/ConverterWikistyleTextToXml.html";
WikiFormat ="WikiFormat.html";
DocuGenCtrl ="DocuGenCtrl.html";
UmlDocu = "UmlDocu.html";
HeaderDocu = "HeaderDocu.html";
insetTechnology ="todo";
Special.xsl ="DocuGenCtrl.html#Special.xsl";
HrefInDocuGenCtrl = "Hyperlink.html";
CorrectHref = "Hyperlink.html#CorrectHref";
Hyperlink-Korrektur = "Hyperlink.html#CorrectHref";
DocuGenXhtmlPre ="DocuGenCtrl.html";
XslHints* = "../../Xml/html/XslHints.html#XslHints_*"; //all XslHints_ are topics with this main label.
TextStyle = "Style.html";
Topics = "Topics.html";
TextTopics = "Topics.html";
TopicsPOT = "Topics.html#TopicsPOT";
Xslt-WhiteSpaces = "../XmlDocuGenerated/XmlDocuVishia.html#chapter_2.4";
vishia-XSLT = "../XmlDocuGenerated/XmlDocuVishia.html#chapter_7";
Beautification = "../XmlDocuGenerated/XmlDocuVishia.html#chapter_2";
SBNF = "../../ZBNF/index.html";
ZBNF = "../../ZBNF/index.html";
Eclipse-Ant="DocuGenCtrl.html#DocuGenCtrl_ANT"; //"www.eclipse.ant.org";
Eclipse-ANT="DocuGenCtrl.html#DocuGenCtrl_ANT"; //"www.eclipse.ant.org";
//xslt.jar = "TODO";
XmlDocuGen_Old="../XmlDocuGenerated/XmlDocuVishia.html";
//Verweise auf andere Dokumente innerhalb vishia
//----------------------------------------------
JcReflection = "../../Jc/oldHtml/Reflection.html";
Cheader2Xmi = "../../SwEng/html/Cheader2Xmi.html";
Zmake = "../../Xml/indexZmake.html";
Pre2Xhtml = "Pre2Xhtml.html";
Pre2Word = "Pre2Word.html";
XhtmlPre-Format = "XhtmlPre.html";
Preprozessor_XSLP = "../../Xml/html/Xsltpre.html";
XSLP-Format = "../../Xml/html/Xsltpre.html";
SBNF-Samples-Header2Xml ="../../SBNF/sample";
vishia-Java = "../../Java/index.html";
//Links nach außen:
//-----------------
>>Java="http://www.java.sun.com";
>>Eclipse-Ant="http://Sourceforge.net/projects/ant-eclipse";
Wikipedia:* = "http://de.wikipedia.org/wiki/*";
*_(Wikipedia) = "http://de.wikipedia.org/wiki/*";
//Downloads sind verteilt im System, aber einheitlich mit einem Schluesselwort download:_ gekennzeichnet:
//-------------------------------------------------------------------------------------------------------
ZBNF_bei_Sourceforge = "http://www.sf.net/projects/ZBNF";
vishia_Downloadpage = "../../indexDownload.html";
download:_xslt.jar = "../../Xml/xslt.jar";
download:_vishia.jar = "../../Xml/JavaVishia.jar";
download:_XmlDocu_xsl = "../../Xml/XSL_Download.zip";
//Schlüsselwort zum Auffinden von Dateien, die Schlüsselworte sollten im normalen Text dargestellt werden können:
//---------------------------------------------------------------------------------------------------------------
javadoc:_* = "../../Java/docuSrcJavaPublic/*.html";
javadoc-src:_* = "../../Java/docuSrcJavaSrc/*.html";
XmlDocu_xsl/* = "../../XmlDocu/html/XmlDocu_xsl/*.html";
xsl/* = "../../Xml/html/xsl/*.html";
XmlDocu/docuSrc/* = "../../XmlDocu/html/XmlDocu/docuSrc/*.html";
XmlDocu_batch/*.bat = "*.bat.html";
ExampleJc:_* = "*.html";
}