Merge Changes

.github/workflows/Repo-Sync.yml

@@ -0,0 +1,18 @@
+# File: .github/workflows/repo-sync.yml
+name: Repo-Sync
+
+on:
+  schedule:
+  - cron:  "35 */3 * * *"
+jobs:
+  repo-sync:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@master
+    - name: repo-sync
+      uses: repo-sync/github-sync@v2
+      with:
+        source_repo: "dgaspary/fpOdf"
+        source_branch: "master"
+        destination_branch: "MasterChanges"
+        github_token: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,5 @@
+/.svn
+/bin
+/output
+*.lps
+*.bak

FPdoc/improveddemo.xml

@@ -9,6 +9,18 @@
       </element><element name="Execute"><short>Execute the demo. First write the chapters in separate files, then write all chapters in one file.</short>
       </element><element name="Done"><short>Cleanup after the execution.</short>
       </element>
+    <element name="COutout1"><short>Name of the first output-file (some styles)</short>
+      </element><element name="COutout2"><short>Name of the second output files (styles bookmarks and links)</short>
+      </element><element name="COutout3"><short>Name of the third output-file (fonts)</short>
+      </element><element name="COutout4"><short>Name of the fourth output-file (colors)</short>
+      </element><element name="COutout5"><short>Name of the fifth output-file (tabs)</short>
+      </element><element name="COutoutAll"><short>Name of the complete document with all parts</short>
+      </element><element name="cStyleName"><short>standard paragraph style-name</short>
+      </element><element name="COutPut"><short>Name of the output-directory</short>
+      </element><element name="Init.i"><short>iteration variable </short>
+      </element><element name="TextWithTabulators"><short>Generate a chapter of the document with a table created with tabulators.</short>
+      </element><element name="TextWithTabulators.RandomText"><short>Generate a random word with a given maximum length</short>
+      </element>
     </module>
   </package>
 </fpdoc-descriptions>

FPdoc/odf_types.xml

@@ -9,6 +9,58 @@
       </element><element name="TBookMark"><short>BookMark is a point in the text the reader can jump to. (see also Hyperlink)</short>
       </element><element name="TOdfTextDocument"><short>OdfTextDocument is the class to use to open, close &amp; modify OpenDocument-Files</short>
       </element><short>fpOdf is a library used to help users to create and to modify OpenDocument Files (ODF)</short>
+    <element name="TOdfElement.Find"><short>Find is a general method to find named items when the name of the item is in the attributes</short>
+      </element><element name="TOdfTextDocument.Clear"><short>Erase all content and create a new document</short>
+      </element><element name="TOdfTextDocument.AddHeadline"><short>Add a heading of a given level </short>
+      </element><element name="TOdfContent.AppendText"><short>Appends a text to a content-block</short>
+      </element><element name="TOdfTextDocument.AddParagraph"><short>Append a new paragraph of a given style</short>
+      </element><element name="TOdfContent.AddSpan" link="TSpan"><short>Add a span to the paragraph</short><descr>A Span is a continuous part of the text with equal style.
+</descr><seealso>TSpan
+</seealso>
+      </element><element name="TOdfContent.AddLineBreak"><short>Appends a (manual) Line-break to the text.</short><descr>a <b>Line-break</b> stops the text at the current position in the line and continues the text at the start of the next line, but all in the same paragraph.
+</descr>
+      </element><element name="TOdfParagraph.AddBookmark"><short>Adds a bookmark to the paragraph</short>
+      </element><element name="TOdfContent.AddLink"><short>appends a link (Hyperlink) to a bookmark</short>
+      </element><element name="TOdfContent.AddTab"><short>Appends a tabulator</short>
+      </element>
+    <element name="TOdfElement.CreateDomElement"><short>creates a DOM element of the specified type</short>
+      </element><element name="TOdfElement.GetElementType"><short>GetElementType returns the element type based on an index.  </short>
+      </element><element name="TOdfElement.GetDocument"><short>the TOdfDocument associated with this element</short>
+      </element><element name="TOdfElement.CreateOdfElement"><short>creates an ODF element of the specified type</short>
+      </element><element name="TOdfElement.OdfGetElementType"><short>Returns the ODF element type for a given DOM element.</short>
+      </element><element name="TOdfElement.SameType"><short>Checks if two DOM elements have the same type.</short>
+      </element><element name="TOdfElement.SetAttribute"><short>Sets an attribute value for the parent element.</short>
+      </element><element name="TOdfElement.OdfGetFirstElement"><short>Returns the first child ODF element of the specified type.</short>
+      </element><element name="TOdfElement.SetOrDeleteAttributes"><short>Sets or deletes attributes based on the specified array. </short>
+      </element><element name="TOdfElement.SetAttributes"><short>Sets multiple attributes with corresponding values. </short>
+      </element><element name="TOdfElement.DeleteAttributes"><short>Deletes multiple attributes specified in the array.  </short>
+      </element><element name="TOdfElement.RemoveAttribute"><short>Removes the attribute of the specified type.</short>
+      </element><element name="TOdfElement.HasAttribute"><short>Checks if the element has the specified attribute.</short>
+      </element><element name="TOdfElement.GetAttributeString"><short>Retrieves the attribute value as a string.</short>
+      </element><element name="TOdfElement.GetAttribute"><short>Retrieves the attribute of the specified type.</short>
+      </element><element name="TOdfElement.FindStyle"><short>Finds an ODF element with the given style name. </short>
+      </element><element name="TOdfElement.HasOdfElement"><short>Checks if the ODF element of the specified type exists. </short>
+      </element><element name="TOdfElement.FindOdfElement"><short>Finds and returns the first ODF element of the specified type.</short>
+      </element><element name="TTextSequenceDecls"><short>Defines a Delaration for a Text-sequence</short>
+      </element><element name="TConfigConfigItemSet"><short>Defines a set of Config-Config-items</short>
+      </element><element name="TConfigConfigItemSet.ConfigName"><short>the name of the config</short>
+      </element><element name="TOdfColor"><short>A color-record with three base-colors</short>
+      </element><element name="TOdfFont"><short>Font-definition for odf-files</short>
+      </element><element name="TOdfSection"><short>Section is collection of Paragraphes of the same formatting</short>
+      </element><element name="TDefaultStyle"><short>a text-style as default</short>
+      </element><element name="cCharSpace"><short>The space/blank character</short>
+      </element><element name="cNone"><short>the None-Tag</short>
+      </element><element name="cFileContent"><short>Name of the content-file</short>
+      </element><element name="cFileStyles"><short>name of the style-file</short>
+      </element><element name="cIsoDateFormat"><short>the date-format in the file</short>
+      </element><element name="cMetaGenerator"><short>the generator-name and version</short>
+      </element><element name="cUrnOpenDocument"><short>odf-namespace-definition</short>
+      </element><element name="cUrlOasis"><short>Url: Oasis</short>
+      </element><element name="cUriOffice12Meta"><short>url: Office</short>
+      </element><element name="cUriOdfMeta"><short>Url: Odf-Meta</short>
+      </element><element name="cUrlW3"><short>Url: W3</short>
+      </element><element name="cOwnerAttr"><short>The 'Owner' attribute</short>
+      </element>
     </module>
   </package>
 </fpdoc-descriptions>

README.md

@@ -1,4 +1,10 @@
 fpOdf
 =====
 
-A library to help freepascal developers to generate and perform modifications to ODF(OASIS OpenDocument) files.
+A library to help freepascal developers to generate and perform modifications to ODF(OASIS OpenDocument) files.<br/>
+
+[Show off (Examples)](examples)
+--------
+<img width="200" src="Resources/ShowStyles.PNG"><img width="200" src="Resources/ShowImage.PNG"><img width="200" src="Resources/ShowLinks.PNG"><br/>
+<img width="600" src="Resources/ShowColor.PNG"><br/>
+[[Demo.pdf]](Resources/AllParts.pdf) and [[German Demo Familybook[pdf]]](Resources/Muster_GEDCOM_UTF-8.pdf)

Resources/BoldText.fodt

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<office:document xmlns:style="urn:oasis:names:tc:opendocument:xmlns:style:1.0" xmlns:svg="urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0" xmlns:fo="urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0" xmlns:office="urn:oasis:names:tc:opendocument:xmlns:office:1.0" xmlns:grddl="http://www.w3.org/2003/g/data-view#" Owner="22503072" grddl:transformation="http://docs.oasis-open.org/office/1.2/xslt/odf2rdf.xsl" office:version="1.2" office:mimetype="application/vnd.oasis.opendocument.text"><office:meta xmlns:meta="urn:oasis:names:tc:opendocument:xmlns:meta:1.0"><meta:creation-date>2021-03-23T19:45:47</meta:creation-date><meta:generator>fpOdf 0.1</meta:generator>
+  </office:meta><office:settings/><office:scripts/><office:font-face-decls><style:font-face style:name="Liberation Mono" svg:font-family="'Liberation Mono'" style:font-family-generic="modern" style:font-pitch="fixed"/><style:font-face style:name="Liberation Sans" svg:font-family="'Liberation Sans'" style:font-family-generic="swiss" style:font-pitch="variable"/><style:font-face style:name="Liberation Sans Narrow" svg:font-family="'Liberation Sans Narrow'" style:font-family-generic="swiss" style:font-pitch="variable"/><style:font-face style:name="Liberation Serif" svg:font-family="'Liberation Serif'" style:font-family-generic="roman" style:font-pitch="variable"/>
+  </office:font-face-decls><office:styles><style:default-style style:family="paragraph"><style:paragraph-properties fo:hyphenation-ladder-count="no-limit" style:text-autospace="ideograph-alpha" style:punctuation-wrap="hanging" style:line-break="strict" style:tab-stop-distance="1.25095cm" style:writing-mode="page"/><style:text-properties style:use-window-font-color="true" style:font-name="Liberation Serif" fo:font-size="12pt" fo:language="en" fo:country="US" style:letter-kerning="true" fo:hyphenate="false" fo:hyphenation-remain-char-count="2" fo:hyphenation-push-char-count="2"/>
+    </style:default-style><style:style style:name="Standard" style:family="paragraph"/>
+  </office:styles><office:automatic-styles><style:style style:name="TA0" style:family="text"><style:text-properties/>
+    </style:style><style:style style:name="TA1" style:family="text"><style:text-properties fo:font-weight="bold"/>
+    </style:style><style:style style:name="TA2" style:family="text"><style:text-properties fo:font-style="italic"/>
+    </style:style><style:style style:name="TA3" style:family="text"><style:text-properties fo:font-weight="bold" fo:font-style="italic"/>
+    </style:style><style:style style:name="TA4" style:family="text"><style:text-properties style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color"/>
+    </style:style><style:style style:name="TA5" style:family="text"><style:text-properties fo:font-weight="bold" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color"/>
+    </style:style><style:style style:name="TA6" style:family="text"><style:text-properties fo:font-style="italic" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color"/>
+    </style:style><style:style style:name="TA7" style:family="text"><style:text-properties fo:font-weight="bold" fo:font-style="italic" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color"/>
+    </style:style><style:style style:name="TA8" style:family="text"><style:text-properties style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA9" style:family="text"><style:text-properties fo:font-weight="bold" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA10" style:family="text"><style:text-properties fo:font-style="italic" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA11" style:family="text"><style:text-properties fo:font-weight="bold" fo:font-style="italic" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA12" style:family="text"><style:text-properties style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA13" style:family="text"><style:text-properties fo:font-weight="bold" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA14" style:family="text"><style:text-properties fo:font-style="italic" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA15" style:family="text"><style:text-properties fo:font-weight="bold" fo:font-style="italic" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style>
+  </office:automatic-styles><office:master-styles/><office:body><office:text><text:p xmlns:text="urn:oasis:names:tc:opendocument:xmlns:text:1.0" text:style-name="Standard">A <text:span text:style-name="TA1">bold</text:span><text:span text:style-name="TA0"> text</text:span>
+      </text:p>
+    </office:text>
+  </office:body>
+</office:document>

Resources/ReplaceFieldsExample.fodt

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<office:document xmlns:style="urn:oasis:names:tc:opendocument:xmlns:style:1.0" xmlns:svg="urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0" xmlns:fo="urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0" xmlns:office="urn:oasis:names:tc:opendocument:xmlns:office:1.0" xmlns:grddl="http://www.w3.org/2003/g/data-view#" Owner="23096832" grddl:transformation="http://docs.oasis-open.org/office/1.2/xslt/odf2rdf.xsl" office:version="1.2" office:mimetype="application/vnd.oasis.opendocument.text"><office:meta xmlns:meta="urn:oasis:names:tc:opendocument:xmlns:meta:1.0"><meta:creation-date>2021-03-23T19:45:53</meta:creation-date><meta:generator>fpOdf 0.1</meta:generator>
+  </office:meta><office:settings/><office:scripts/><office:font-face-decls><style:font-face style:name="Liberation Mono" svg:font-family="'Liberation Mono'" style:font-family-generic="modern" style:font-pitch="fixed"/><style:font-face style:name="Liberation Sans" svg:font-family="'Liberation Sans'" style:font-family-generic="swiss" style:font-pitch="variable"/><style:font-face style:name="Liberation Sans Narrow" svg:font-family="'Liberation Sans Narrow'" style:font-family-generic="swiss" style:font-pitch="variable"/><style:font-face style:name="Liberation Serif" svg:font-family="'Liberation Serif'" style:font-family-generic="roman" style:font-pitch="variable"/>
+  </office:font-face-decls><office:styles><style:default-style style:family="paragraph"><style:paragraph-properties fo:hyphenation-ladder-count="no-limit" style:text-autospace="ideograph-alpha" style:punctuation-wrap="hanging" style:line-break="strict" style:tab-stop-distance="1.25095cm" style:writing-mode="page"/><style:text-properties style:use-window-font-color="true" style:font-name="Liberation Serif" fo:font-size="12pt" fo:language="en" fo:country="US" style:letter-kerning="true" fo:hyphenate="false" fo:hyphenation-remain-char-count="2" fo:hyphenation-push-char-count="2"/>
+    </style:default-style><style:style style:name="Standard" style:family="paragraph"/>
+  </office:styles><office:automatic-styles><style:style style:name="TA0" style:family="text"><style:text-properties/>
+    </style:style><style:style style:name="TA1" style:family="text"><style:text-properties fo:font-weight="bold"/>
+    </style:style><style:style style:name="TA2" style:family="text"><style:text-properties fo:font-style="italic"/>
+    </style:style><style:style style:name="TA3" style:family="text"><style:text-properties fo:font-weight="bold" fo:font-style="italic"/>
+    </style:style><style:style style:name="TA4" style:family="text"><style:text-properties style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color"/>
+    </style:style><style:style style:name="TA5" style:family="text"><style:text-properties fo:font-weight="bold" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color"/>
+    </style:style><style:style style:name="TA6" style:family="text"><style:text-properties fo:font-style="italic" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color"/>
+    </style:style><style:style style:name="TA7" style:family="text"><style:text-properties fo:font-weight="bold" fo:font-style="italic" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color"/>
+    </style:style><style:style style:name="TA8" style:family="text"><style:text-properties style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA9" style:family="text"><style:text-properties fo:font-weight="bold" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA10" style:family="text"><style:text-properties fo:font-style="italic" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA11" style:family="text"><style:text-properties fo:font-weight="bold" fo:font-style="italic" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA12" style:family="text"><style:text-properties style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA13" style:family="text"><style:text-properties fo:font-weight="bold" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA14" style:family="text"><style:text-properties fo:font-style="italic" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style><style:style style:name="TA15" style:family="text"><style:text-properties fo:font-weight="bold" fo:font-style="italic" style:text-underline-style="solid" style:text-underline-width="auto" style:text-underline-color="font-color" style:text-line-through-style="solid" style:text-line-through-type="single"/>
+    </style:style>
+  </office:automatic-styles><office:master-styles/><office:body><office:text><text:p xmlns:text="urn:oasis:names:tc:opendocument:xmlns:text:1.0" text:style-name="Standard"><text:span text:style-name="Standard">Name:</text:span><text:tab/><text:text-input text:description="Name">Arthur</text:text-input>
+      </text:p><text:p xmlns:text="urn:oasis:names:tc:opendocument:xmlns:text:1.0" text:style-name="Standard"><text:span text:style-name="Standard">Age:</text:span><text:tab/><text:text-input text:description="Age">35</text:text-input>
+      </text:p>
+    </office:text>
+  </office:body>
+</office:document>