Added a sample project. Updated README to include a link to the Pokémon GO IV calculator as an example project.

2017-08-02 14:44:45 +08:00 · 2017-08-02 14:44:45 +08:00 · 373440a4c1
commit 373440a4c1
parent 0ea980ce5d
77 changed files with 1419 additions and 0 deletions
--- a/README.rst
+++ b/README.rst
@ -37,6 +37,13 @@ source files:
 Missing source files will be added, and excess source files will be
 deleted.

+Check the presentation_ on how ``obasync`` can be used to manage your
+Office Basic extension projects.
+
+Check `the Pokémon GO IV calculator
+<https://github.com/imacat/pokemongoiv>`_ for an example Office Basic
+extension project that is managed with ``obasync`` and ``git``.
+

 INSTALL
 -------
@ -277,6 +284,8 @@ LIBRARY         The name of the Basic library.  Default to the same
 DEMONSTRATION/PRESENTATION
 --------------------------

+.. _presentation:
+
 FOSDEM 2017 - Office Basic Source Code Management
 #################################################

--- a/sample-project/README
+++ b/sample-project/README
@ -0,0 +1,57 @@
+sampleproject - A Sample OpenOffice Basic Extension Project Template
+
+
+DESCRIPTION
+
+    sampleproject is a sample OpenOffice/LibreOffice Basic extension
+project template.  It is designed to demonstrate how to manage an
+OpenOffice/LibreOffice Basic extension project with obasync, the
+Office Basic Macro Source Synchronizer, and other code management
+tools like Apache Ant, Git, Dropbox, etc.  You may modify it to
+create your own OpenOffice/LibreOffice Basic extension project.
+
+    sampleproject use Apache Ant as its build system.  Obtain Apache
+Ant at: https://ant.apache.org/.
+
+    Available Ant commands:
+
+ant oxt    # Create the extension SampleProject.oxt
+ant dist   # Create the pacakge distribution as sampleproject-0.0.1.zip
+ant clean  # Clean-up the build files
+ant help   # Display this help
+
+    The oxt directory contains files to be included in the extension.
+The SampleProject is the directory with .xba XML files exported from
+OpenOffice/LibreOffice Basic.  When the development come to a point
+and you want to create a new release, export the project from
+OpenOffice/LibreOffice Basic and replace this directory.
+
+
+DOWNLOAD
+
+    sampleproject is shipped with obasync, the Office Basic Macro
+Source Synchronizer.  Download obasync at:
+
+https://github.com/imacat/obasync
+
+
+COPYRIGHT
+
+  Copyright (c) 2017 imacat.
+  
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+  
+      http://www.apache.org/licenses/LICENSE-2.0
+  
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+
+
+imacat
+imacat@mail.imacat.idv.tw
+2017-08-01
--- a/sample-project/SampleProject.oxt
+++ b/sample-project/SampleProject.oxt
--- a/sample-project/SampleProject/MyModule.vb
+++ b/sample-project/SampleProject/MyModule.vb
@ -0,0 +1,19 @@
+' MyModule: The main module of the sample project
+'   by imacat <imacat@mail.imacat.idv.tw>, 2017-08-01
+
+Option Explicit
+
+' Main: The main program
+Sub Main
+    Dim oDialog As Object
+    
+	DialogLibraries.loadLibrary "SampleProject"
+	oDialog = CreateUnoDialog (DialogLibraries.SampleProject.MyDialog)
+	' Cancelled
+	If oDialog.execute = 0 Then
+		Exit Sub
+	End If
+	
+	
+	MsgBox GetResString ("DinnerChoice") & oDialog.getControl ("MenuList1").getSelectedItem
+End Sub
--- a/sample-project/SampleProject/Registry.vb
+++ b/sample-project/SampleProject/Registry.vb
@ -0,0 +1,46 @@
+' Registry: Utilities to access to private configuration
+'   Taken from TextToColumns, 2017-08-02
+
+Option Explicit
+
+' TODO: Replace SampleProject with your own project name
+Const BASE_KEY As String = "/org.openoffice.Office.Addons.SampleProject.AddonConfiguration/"
+
+' GetImageUrl: Returns the image URL for the UNO image controls.
+Function GetImageUrl (sName As String) As String
+	BasicLibraries.loadLibrary "Tools"
+	Dim oRegKey As Object
+	
+	oRegKey = GetRegistryKeyContent (BASE_KEY & "FileResources/" & sName)
+	GetImageUrl = ExpandMacroFieldExpression (oRegKey.Url)
+End Function
+
+' GetResString: Returns the localized text string.
+Function GetResString (sID As String) As String
+	BasicLibraries.loadLibrary "Tools"
+	Dim oRegKey As Object
+	
+	oRegKey = GetRegistryKeyContent (BASE_KEY & "Messages/" & sID)
+	GetResString = oRegKey.Text
+End Function
+
+' ExpandMacroFieldExpression
+Function ExpandMacroFieldExpression (sURL As String) As String
+	Dim sTemp As String
+	Dim oSM As Object
+	Dim oMacroExpander As Object
+	
+	' Gets the service manager
+	oSM = getProcessServiceManager
+	' Gets the macro expander
+	oMacroExpander = oSM.DefaultContext.getValueByName ( _
+		"/singletons/com.sun.star.util.theMacroExpander")
+	
+	'cut the vnd.sun.star.expand: part
+	sTemp = Join (Split (sURL, "vnd.sun.star.expand:"))
+	
+	'Expand the macrofield expression
+	sTemp = oMacroExpander.ExpandMacros (sTemp)
+	sTemp = Trim (sTemp)
+	ExpandMacroFieldExpression = sTemp
+End Function
--- a/sample-project/VERSION
+++ b/sample-project/VERSION
@ -0,0 +1 @@
+0.0.1
--- a/sample-project/build.xml
+++ b/sample-project/build.xml
@ -0,0 +1,65 @@
+<?xml version="1.0"?>
+<!-- TODO: Replace it with your own comment. -->
+<!-- build.xml: Ant build file for the SampleProject project -->
+<!--   by imacat <imacat@mail.imacat.idv.tw>, 2017-08-01 -->
+<!-- TODO: Replace it with your own project name. -->
+<project name="sampleproject" default="help" basedir=".">
+<!-- property: The build variables -->
+<loadfile property="project.version" srcfile="${basedir}/VERSION">
+    <filterchain>
+        <striplinebreaks />
+    </filterchain>
+</loadfile>
+<!-- TODO: Replace it with your own project name. -->
+<property name="proj.name.basic" value="SampleProject" />
+<property name="src.dir" value="${basedir}/oxt" />
+<property name="build.dir" value="build" />
+<property name="dist.build.dir" value="${build.dir}/dist" />
+<property name="dist.dir" value="${basedir}" />
+<property name="src.build.dir" value="${build.dir}/${proj.name.basic}" />
+
+<!-- help: Display the help information -->
+<target name="help">
+    <echo level="info" message="Available targets:" />
+    <echo level="info" message=" oxt:    Create the extension ${proj.name.basic}.oxt" />
+    <echo level="info" message=" dist:   Create the pacakge distribution as ${ant.project.name}-${project.version}.zip" />
+    <echo level="info" message=" clean:  Clean-up the build files" />
+    <echo level="info" message=" help:   Display this help" />
+</target>
+
+<!-- oxt: Create the extension -->
+<target name="oxt">
+    <copy todir="${src.build.dir}"
+            preservelastmodified="true">
+        <fileset dir="${src.dir}" />
+    </copy>
+    <replace file="${src.build.dir}/description.xml"
+        token="@VERSION@" value="${project.version}" />
+    <zip destfile="${basedir}/${proj.name.basic}.oxt"
+        basedir="${src.build.dir}" />
+</target>
+
+<!-- -distdir: Create the distribution directory -->
+<target name="-distdir" depends="oxt">
+    <copy todir="${dist.build.dir}/${ant.project.name}-${project.version}"
+            preservelastmodified="true">
+        <fileset dir="${basedir}"
+            excludes="${build.dir}/ ${ant.project.name}-*.zip excludes/" />
+    </copy>
+</target>
+
+<!-- dist: Create the pacakge distribution -->
+<target name="dist" depends="-distdir">
+    <zip destfile="${dist.dir}/${ant.project.name}-${project.version}.zip"
+        basedir="${dist.build.dir}" />
+</target>
+
+<!-- clean: Clean-up the build files -->
+<target name="clean">
+    <delete dir="${build.dir}" />
+    <delete verbose="true">
+        <fileset file="${dist.dir}/${ant.project.name}-*.zip*" />
+        <fileset file="${basedir}/${proj.name.basic}.oxt" />
+    </delete>
+</target>
+</project>
--- a/sample-project/build/SampleProject/AddonConfiguration.xcs
+++ b/sample-project/build/SampleProject/AddonConfiguration.xcs
@ -0,0 +1,38 @@
+<?xml version='1.0' encoding='UTF-8'?>
+
+<!-- TODO: Replace SampleProject with your own project name. -->
+<oor:component-schema oor:name="AddonConfiguration" oor:package="org.openoffice.Office.Addons.SampleProject" xml:lang="en-US" xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+	<templates>
+		<group oor:name="Contributor">
+			<prop oor:name="ContributorName" oor:type="xs:string"/>
+			<prop oor:name="Email" oor:type="xs:string"/>
+			<prop oor:name="Copyright" oor:type="xs:string"/>
+		</group>
+		<group oor:name="Translator">
+			<prop oor:name="TranslatorName" oor:type="xs:string"/>
+			<prop oor:name="Email" oor:type="xs:string"/>
+			<prop oor:name="Language" oor:type="xs:string"/>
+		</group>
+		<group oor:name="Message">
+			<prop oor:name="Text" oor:type="xs:string" oor:localized="true"/>
+		</group>
+		<group oor:name="FileResource">
+			<prop oor:name="Url" oor:type="xs:string" oor:localized="true"/>
+		</group>
+	</templates>
+	<component>
+		<group oor:name="ProductInfo">
+			<prop oor:name="ProductName" oor:type="xs:string"/>
+			<prop oor:name="Description" oor:type="xs:string" oor:localized="true"/>
+			<prop oor:name="Version" oor:type="xs:string"/>
+			<prop oor:name="License" oor:type="xs:string"/>
+			<prop oor:name="AuthorName" oor:type="xs:string" oor:localized="true"/>
+			<prop oor:name="AuthorEmail" oor:type="xs:string"/>
+			<prop oor:name="Copyright" oor:type="xs:string" oor:localized="true"/>
+			<set oor:name="Contributors" oor:node-type="Contributor"/>
+			<set oor:name="Translators" oor:node-type="Translator"/>
+		</group>
+		<set oor:name="FileResources" oor:node-type="FileResource"/>
+		<set oor:name="Messages" oor:node-type="Message"/>
+	</component>
+</oor:component-schema>
--- a/sample-project/build/SampleProject/AddonConfiguration.xcu
+++ b/sample-project/build/SampleProject/AddonConfiguration.xcu
@ -0,0 +1,55 @@
+<?xml version='1.0' encoding='UTF-8'?>
+
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" oor:name="AddonConfiguration" oor:package="org.openoffice.Office.Addons.SampleProject">
+
+<!--  General infos -->
+    <!-- TODO: Replace it with your own project information. -->
+	<node oor:name="ProductInfo">
+		<prop oor:name="ProductName" oor:type="xs:string">
+			<value>SampleProject</value>
+		</prop>
+		<prop oor:name="Description" oor:type="xs:string" oor:localized="true">
+			<value>A Sample OpenOffice/LibreOffice Basic extension project template.</value>
+			<value xml:lang="zh-TW">OpenOffice/LibreOffice Basic擴充套件專案範本。</value>
+		</prop>
+		<prop oor:name="Version" oor:type="xs:string">
+			<value>@VERSION@</value>
+		</prop>
+		<prop oor:name="License" oor:type="xs:string">
+			<value>Apache License</value>
+		</prop>
+		<prop oor:name="AuthorName" oor:type="xs:string" oor:localized="true">
+			<value>(Jane Doe)</value>
+			<value xml:lang="zh-TW">（陳小芬）</value>
+		</prop>
+		<prop oor:name="AuthorEmail" oor:type="xs:string">
+			<value>jane.doe@example.com</value>
+		</prop>
+		<prop oor:name="Copyright" oor:type="xs:string" oor:localized="true">
+			<value>Copyright &#169; 2017 imacat</value>
+			<value xml:lang="zh-TW">版權所有 &#169; 2017 依瑪貓</value>
+		</prop>
+		<node oor:name="Contributors"/>
+		<node oor:name="Translators">
+		</node>
+	</node>
+	
+<!--  Localized messages -->
+	<node oor:name="Messages">
+		<node oor:name="DinnerChoice" oor:op="replace">		
+			<prop oor:name="Text" oor:type="xs:string" oor:localized="true">	
+				<value>Dinner Choice</value>
+				<value xml:lang="zh-TW">晚餐選擇：</value>
+			</prop>
+		</node>
+	</node>
+	
+<!--  File resources (supports localization) -->
+	<node oor:name="FileResources">
+		<node oor:name="Unknown" oor:op="replace">
+			<prop oor:name="Url" oor:type="xs:string" oor:localized="true">
+				<value>%origin%/icons/unknown.png</value>
+			</prop>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/Addons.xcu
+++ b/sample-project/build/SampleProject/Addons.xcu
@ -0,0 +1,65 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<oor:component-data 
+ xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="Addons"
+ oor:package="org.openoffice.Office">
+	<node oor:name="AddonUI">
+		<node oor:name="OfficeToolBar">
+		    <!-- TODO: Replace SampleProject with your own project name. -->
+			<node oor:name="SampleProject.OfficeToolBar" oor:op="replace">
+				<!-- Start of OpenOffice 4.x compatibility -->
+				<!-- TODO: Replace it with your own project title. -->
+				<prop oor:name="Title">
+					<value>Sample Basic Extension Template</value>
+					<value xml:lang="zh-TW">Basic擴充套件範本</value>
+				</prop>
+				<node oor:name="ToolBarItems">
+					<node oor:name="m001" oor:op="replace">
+						<prop oor:name="Context" oor:type="xs:string">
+							<value></value>
+						</prop>
+						<!-- TODO: Replace SampleProject with your own project name. -->
+						<prop oor:name="URL" oor:type="xs:string">
+							<value>vnd.sun.star.script:SampleProject.MyModule.Main?language=Basic&amp;location=application</value>
+						</prop>
+						<prop oor:name="ImageIdentifier" oor:type="xs:string">
+							<value>%origin%/icons/image1</value>
+						</prop>
+						<!-- TODO: Replace it with your own toolbar button title. -->
+						<prop oor:name="Title" oor:type="xs:string">
+							<value>Sample Basic Extension Template</value>
+							<value xml:lang="zh-TW">Basic擴充套件範本</value>
+						</prop>
+						<prop oor:name="Target" oor:type="xs:string">
+							<value>_self</value>
+						</prop>
+					</node>
+				</node>
+				<!-- End of OpenOffice 4.x compatibility -->
+				<!-- Start of OpenOffice 3.x and LibreOffce compatibility -->
+				<node oor:name="m001" oor:op="replace">
+					<prop oor:name="Context" oor:type="xs:string">
+						<value></value>
+					</prop>
+					<!-- TODO: Replace SampleProject with your own project name. -->
+					<prop oor:name="URL" oor:type="xs:string">
+						<value>vnd.sun.star.script:SampleProject.MyModule.Main?language=Basic&amp;location=application</value>
+					</prop>
+					<prop oor:name="ImageIdentifier" oor:type="xs:string">
+						<value>%origin%/icons/image1</value>
+					</prop>
+					<!-- TODO: Replace it with your own toolbar button title. -->
+					<prop oor:name="Title" oor:type="xs:string">
+						<value>Sample Basic Extension Template</value>
+						<value xml:lang="zh-TW">Basic擴充套件範本</value>
+					</prop>
+					<prop oor:name="Target" oor:type="xs:string">
+						<value>_self</value>
+					</prop>
+				</node>
+				<!-- End of OpenOffice 3.x and LibreOffce compatibility -->
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/META-INF/manifest.xml
+++ b/sample-project/build/SampleProject/META-INF/manifest.xml
@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<manifest:manifest>
+  <!-- TODO: Replace SampleProject with your own project folder name. -->
+ <manifest:file-entry manifest:full-path="SampleProject/" manifest:media-type="application/vnd.sun.star.basic-library"/>
+ <manifest:file-entry manifest:full-path="pkg-desc/pkg-description.txt" manifest:media-type="application/vnd.sun.star.package-bundle-description"/>
+ <manifest:file-entry manifest:full-path="pkg-desc/pkg-description.zh-TW.txt" manifest:media-type="application/vnd.sun.star.package-bundle-description;locale=zh-TW"/>
+ <manifest:file-entry manifest:full-path="AddonConfiguration.xcs" manifest:media-type="application/vnd.sun.star.configuration-schema"/>
+ <manifest:file-entry manifest:full-path="AddonConfiguration.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Addons.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/BaseWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/BasicIDEWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/CalcWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/DrawWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/ImpressWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/MathWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/StartModuleWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/WriterWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+</manifest:manifest>
--- a/sample-project/build/SampleProject/Office/UI/BaseWindowState.xcu
+++ b/sample-project/build/SampleProject/Office/UI/BaseWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="BaseWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/Office/UI/BasicIDEWindowState.xcu
+++ b/sample-project/build/SampleProject/Office/UI/BasicIDEWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="BasicIDEWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/Office/UI/CalcWindowState.xcu
+++ b/sample-project/build/SampleProject/Office/UI/CalcWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="CalcWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/Office/UI/DrawWindowState.xcu
+++ b/sample-project/build/SampleProject/Office/UI/DrawWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="DrawWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/Office/UI/ImpressWindowState.xcu
+++ b/sample-project/build/SampleProject/Office/UI/ImpressWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="ImpressWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/Office/UI/MathWindowState.xcu
+++ b/sample-project/build/SampleProject/Office/UI/MathWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="MathWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/Office/UI/StartModuleWindowState.xcu
+++ b/sample-project/build/SampleProject/Office/UI/StartModuleWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="StartModuleWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/Office/UI/WriterWindowState.xcu
+++ b/sample-project/build/SampleProject/Office/UI/WriterWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="WriterWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/build/SampleProject/SampleProject/DialogStrings_en_US.default
+++ b/sample-project/build/SampleProject/SampleProject/DialogStrings_en_US.default
--- a/sample-project/build/SampleProject/SampleProject/DialogStrings_en_US.properties
+++ b/sample-project/build/SampleProject/SampleProject/DialogStrings_en_US.properties
@ -0,0 +1,9 @@
+# Strings for Dialog Library SampleProject
+0.MyDialog.HelpText=
+1.MyDialog.Title=Dinner Choices
+2.MyDialog.Label1.HelpText=
+3.MyDialog.Label1.Label=Dinner:
+4.MenuList1.StringItemList=Beef
+5.MenuList1.StringItemList=Pork
+6.MenuList1.StringItemList=Chicken
+7.MenuList1.StringItemList=Fish
--- a/sample-project/build/SampleProject/SampleProject/DialogStrings_zh_TW.properties
+++ b/sample-project/build/SampleProject/SampleProject/DialogStrings_zh_TW.properties
@ -0,0 +1,9 @@
+# Strings for Dialog Library SampleProject
+0.MyDialog.HelpText=
+1.MyDialog.Title=\u9910\u9EDE\u9078\u64C7
+2.MyDialog.Label1.HelpText=
+3.MyDialog.Label1.Label=\u9910\u9EDE\uFF1A
+4.MenuList1.StringItemList=\u725B\u8089
+5.MenuList1.StringItemList=\u8C6C\u8089
+6.MenuList1.StringItemList=\u96DE\u8089
+7.MenuList1.StringItemList=\u9B5A\u8089
--- a/sample-project/build/SampleProject/SampleProject/MyDialog.xdl
+++ b/sample-project/build/SampleProject/SampleProject/MyDialog.xdl
@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE dlg:window PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "dialog.dtd">
+<dlg:window xmlns:dlg="http://openoffice.org/2000/dialog" xmlns:script="http://openoffice.org/2000/script" dlg:id="MyDialog" dlg:left="200" dlg:top="100" dlg:width="100" dlg:height="35" dlg:help-text="&amp;0.MyDialog.HelpText" dlg:closeable="true" dlg:moveable="true" dlg:title="&amp;1.MyDialog.Title">
+ <dlg:bulletinboard>
+  <dlg:text dlg:id="Label1" dlg:tab-index="0" dlg:left="5" dlg:top="6" dlg:width="45" dlg:height="8" dlg:help-text="&amp;2.MyDialog.Label1.HelpText" dlg:value="&amp;3.MyDialog.Label1.Label"/>
+  <dlg:menulist dlg:id="MenuList1" dlg:tab-index="1" dlg:left="50" dlg:top="4" dlg:width="45" dlg:height="12" dlg:spin="true">
+   <dlg:menupopup>
+    <dlg:menuitem dlg:value="&amp;4.MenuList1.StringItemList"/>
+    <dlg:menuitem dlg:value="&amp;5.MenuList1.StringItemList"/>
+    <dlg:menuitem dlg:value="&amp;6.MenuList1.StringItemList"/>
+    <dlg:menuitem dlg:value="&amp;7.MenuList1.StringItemList"/>
+   </dlg:menupopup>
+  </dlg:menulist>
+  <dlg:button dlg:id="CommandButton1" dlg:tab-index="2" dlg:left="5" dlg:top="19" dlg:width="40" dlg:height="12" dlg:default="true" dlg:button-type="ok"/>
+  <dlg:button dlg:id="CommandButton2" dlg:tab-index="3" dlg:left="55" dlg:top="19" dlg:width="40" dlg:height="12" dlg:button-type="cancel"/>
+ </dlg:bulletinboard>
+</dlg:window>
--- a/sample-project/build/SampleProject/SampleProject/MyModule.xba
+++ b/sample-project/build/SampleProject/SampleProject/MyModule.xba
@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE script:module PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "module.dtd">
+<script:module xmlns:script="http://openoffice.org/2000/script" script:name="MyModule" script:language="StarBasic">&apos; MyModule: The main module of the sample project
+&apos;   by imacat &lt;imacat@mail.imacat.idv.tw&gt;, 2017-08-01
+
+Option Explicit
+
+&apos; Main: The main program
+Sub Main
+	
+	MsgBox &quot;OK&quot;
+	
+End Sub
+</script:module>
--- a/sample-project/build/SampleProject/SampleProject/dialog.xlb
+++ b/sample-project/build/SampleProject/SampleProject/dialog.xlb
@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE library:library PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "library.dtd">
+<library:library xmlns:library="http://openoffice.org/2000/library" library:name="SampleProject" library:readonly="false" library:passwordprotected="false">
+ <library:element library:name="MyDialog"/>
+</library:library>
--- a/sample-project/build/SampleProject/SampleProject/script.xlb
+++ b/sample-project/build/SampleProject/SampleProject/script.xlb
@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE library:library PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "library.dtd">
+<library:library xmlns:library="http://openoffice.org/2000/library" library:name="SampleProject" library:readonly="false" library:passwordprotected="false">
+ <library:element library:name="MyModule"/>
+</library:library>
--- a/sample-project/build/SampleProject/description.xml
+++ b/sample-project/build/SampleProject/description.xml
@ -0,0 +1,38 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<description
+ xmlns="http://openoffice.org/extensions/description/2006"
+ xmlns:dep="http://openoffice.org/extensions/description/2006"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
+    <!-- TODO: Replace it with your own project project identifier. -->
+	<identifier value="com.example.officebasic.sampleproject"/>
+	<version value="0.0.1"/>
+	<!-- <dependencies>
+		<OpenOffice.org-minimal-version value="2.1" dep:name="OpenOffice.org 2.1"/>
+	</dependencies> -->
+	<publisher>
+	    <!-- TODO: Replace it with your own name and URL.
+	        Remove xlink:href="…" if you don't have an URL for yourself. -->
+		<name xlink:href="http://www.example.com/">(Jane Doe)</name>
+		<name lang="zh-TW" xlink:href="http://www.example.com/">（陳小芬）</name>
+	</publisher>
+	<registration>
+		<simple-license accept-by="admin" default-license-id="ID0" suppress-on-update="true" >
+			<license-text xlink:href="registration/LICENSE" lang="en" license-id="ID0" />
+		</simple-license>
+	</registration>
+	<display-name>
+	    <!-- TODO: Replace it with your own project name. -->
+		<name>(Sample Project)</name>
+		<name lang="zh-TW">（範例專案）</name>
+	</display-name>
+	<!-- TODO: Replace it with your own project icon,
+	    or remove this <icon>…</icon> section entirely. -->
+	<icon>
+		<default xlink:href="icons/sampleproject.png" />
+	</icon>
+	<!-- TODO: Replace it with your own project update information URL,
+	    or remove this <update-information>…</update-information> section entirely. -->
+	<update-information>
+		<src xlink:href="http://update.example.com/officebasic/sampleproject.update.xml" />
+	</update-information>
+</description>
--- a/sample-project/build/SampleProject/icons/image1_16.bmp
+++ b/sample-project/build/SampleProject/icons/image1_16.bmp
--- a/sample-project/build/SampleProject/icons/image1_16h.bmp
+++ b/sample-project/build/SampleProject/icons/image1_16h.bmp
--- a/sample-project/build/SampleProject/icons/image1_26.bmp
+++ b/sample-project/build/SampleProject/icons/image1_26.bmp
--- a/sample-project/build/SampleProject/icons/image1_26h.bmp
+++ b/sample-project/build/SampleProject/icons/image1_26h.bmp
--- a/sample-project/build/SampleProject/icons/pokemongoiv.png
+++ b/sample-project/build/SampleProject/icons/pokemongoiv.png
--- a/sample-project/build/SampleProject/icons/team-leader-blanche.png
+++ b/sample-project/build/SampleProject/icons/team-leader-blanche.png
--- a/sample-project/build/SampleProject/icons/team-leader-candela.png
+++ b/sample-project/build/SampleProject/icons/team-leader-candela.png
--- a/sample-project/build/SampleProject/icons/team-leader-spark.png
+++ b/sample-project/build/SampleProject/icons/team-leader-spark.png
--- a/sample-project/build/SampleProject/icons/team-logo-instinct.png
+++ b/sample-project/build/SampleProject/icons/team-logo-instinct.png
--- a/sample-project/build/SampleProject/icons/team-logo-mystic.png
+++ b/sample-project/build/SampleProject/icons/team-logo-mystic.png
--- a/sample-project/build/SampleProject/icons/team-logo-valor.png
+++ b/sample-project/build/SampleProject/icons/team-logo-valor.png
--- a/sample-project/build/SampleProject/icons/unknown.png
+++ b/sample-project/build/SampleProject/icons/unknown.png
--- a/sample-project/build/SampleProject/pkg-desc/pkg-description.txt
+++ b/sample-project/build/SampleProject/pkg-desc/pkg-description.txt
@ -0,0 +1,4 @@
+SampleProject - A Sample OpenOffice Basic Extension Project Template
+Copyright (c) 2017 imacat 
+
+A Sample OpenOffice/LibreOffice Basic extension project template.
--- a/sample-project/build/SampleProject/pkg-desc/pkg-description.zh-TW.txt
+++ b/sample-project/build/SampleProject/pkg-desc/pkg-description.zh-TW.txt
@ -0,0 +1,4 @@
+SampleProject - OpenOffice Basic擴充套件專案範本
+版權所有 (c) 2017 依瑪貓
+
+OpenOffice/LibreOffice Basic擴充套件專案範本。
--- a/sample-project/build/SampleProject/registration/LICENSE
+++ b/sample-project/build/SampleProject/registration/LICENSE
@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
--- a/sample-project/oxt/AddonConfiguration.xcs
+++ b/sample-project/oxt/AddonConfiguration.xcs
@ -0,0 +1,38 @@
+<?xml version='1.0' encoding='UTF-8'?>
+
+<!-- TODO: Replace SampleProject with your own project name. -->
+<oor:component-schema oor:name="AddonConfiguration" oor:package="org.openoffice.Office.Addons.SampleProject" xml:lang="en-US" xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+	<templates>
+		<group oor:name="Contributor">
+			<prop oor:name="ContributorName" oor:type="xs:string"/>
+			<prop oor:name="Email" oor:type="xs:string"/>
+			<prop oor:name="Copyright" oor:type="xs:string"/>
+		</group>
+		<group oor:name="Translator">
+			<prop oor:name="TranslatorName" oor:type="xs:string"/>
+			<prop oor:name="Email" oor:type="xs:string"/>
+			<prop oor:name="Language" oor:type="xs:string"/>
+		</group>
+		<group oor:name="Message">
+			<prop oor:name="Text" oor:type="xs:string" oor:localized="true"/>
+		</group>
+		<group oor:name="FileResource">
+			<prop oor:name="Url" oor:type="xs:string" oor:localized="true"/>
+		</group>
+	</templates>
+	<component>
+		<group oor:name="ProductInfo">
+			<prop oor:name="ProductName" oor:type="xs:string"/>
+			<prop oor:name="Description" oor:type="xs:string" oor:localized="true"/>
+			<prop oor:name="Version" oor:type="xs:string"/>
+			<prop oor:name="License" oor:type="xs:string"/>
+			<prop oor:name="AuthorName" oor:type="xs:string" oor:localized="true"/>
+			<prop oor:name="AuthorEmail" oor:type="xs:string"/>
+			<prop oor:name="Copyright" oor:type="xs:string" oor:localized="true"/>
+			<set oor:name="Contributors" oor:node-type="Contributor"/>
+			<set oor:name="Translators" oor:node-type="Translator"/>
+		</group>
+		<set oor:name="FileResources" oor:node-type="FileResource"/>
+		<set oor:name="Messages" oor:node-type="Message"/>
+	</component>
+</oor:component-schema>
--- a/sample-project/oxt/AddonConfiguration.xcu
+++ b/sample-project/oxt/AddonConfiguration.xcu
@ -0,0 +1,55 @@
+<?xml version='1.0' encoding='UTF-8'?>
+
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" oor:name="AddonConfiguration" oor:package="org.openoffice.Office.Addons.SampleProject">
+
+<!--  General infos -->
+    <!-- TODO: Replace it with your own project information. -->
+	<node oor:name="ProductInfo">
+		<prop oor:name="ProductName" oor:type="xs:string">
+			<value>SampleProject</value>
+		</prop>
+		<prop oor:name="Description" oor:type="xs:string" oor:localized="true">
+			<value>A Sample OpenOffice/LibreOffice Basic extension project template.</value>
+			<value xml:lang="zh-TW">OpenOffice/LibreOffice Basic擴充套件專案範本。</value>
+		</prop>
+		<prop oor:name="Version" oor:type="xs:string">
+			<value>@VERSION@</value>
+		</prop>
+		<prop oor:name="License" oor:type="xs:string">
+			<value>Apache License</value>
+		</prop>
+		<prop oor:name="AuthorName" oor:type="xs:string" oor:localized="true">
+			<value>(Jane Doe)</value>
+			<value xml:lang="zh-TW">（陳小芬）</value>
+		</prop>
+		<prop oor:name="AuthorEmail" oor:type="xs:string">
+			<value>jane.doe@example.com</value>
+		</prop>
+		<prop oor:name="Copyright" oor:type="xs:string" oor:localized="true">
+			<value>Copyright &#169; 2017 imacat</value>
+			<value xml:lang="zh-TW">版權所有 &#169; 2017 依瑪貓</value>
+		</prop>
+		<node oor:name="Contributors"/>
+		<node oor:name="Translators">
+		</node>
+	</node>
+	
+<!--  Localized messages -->
+	<node oor:name="Messages">
+		<node oor:name="DinnerChoice" oor:op="replace">		
+			<prop oor:name="Text" oor:type="xs:string" oor:localized="true">	
+				<value>Dinner Choice</value>
+				<value xml:lang="zh-TW">晚餐選擇：</value>
+			</prop>
+		</node>
+	</node>
+	
+<!--  File resources (supports localization) -->
+	<node oor:name="FileResources">
+		<node oor:name="Unknown" oor:op="replace">
+			<prop oor:name="Url" oor:type="xs:string" oor:localized="true">
+				<value>%origin%/icons/unknown.png</value>
+			</prop>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/Addons.xcu
+++ b/sample-project/oxt/Addons.xcu
@ -0,0 +1,65 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<oor:component-data 
+ xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="Addons"
+ oor:package="org.openoffice.Office">
+	<node oor:name="AddonUI">
+		<node oor:name="OfficeToolBar">
+		    <!-- TODO: Replace SampleProject with your own project name. -->
+			<node oor:name="SampleProject.OfficeToolBar" oor:op="replace">
+				<!-- Start of OpenOffice 4.x compatibility -->
+				<!-- TODO: Replace it with your own project title. -->
+				<prop oor:name="Title">
+					<value>Sample Basic Extension Template</value>
+					<value xml:lang="zh-TW">Basic擴充套件範本</value>
+				</prop>
+				<node oor:name="ToolBarItems">
+					<node oor:name="m001" oor:op="replace">
+						<prop oor:name="Context" oor:type="xs:string">
+							<value></value>
+						</prop>
+						<!-- TODO: Replace SampleProject with your own project name. -->
+						<prop oor:name="URL" oor:type="xs:string">
+							<value>vnd.sun.star.script:SampleProject.MyModule.Main?language=Basic&amp;location=application</value>
+						</prop>
+						<prop oor:name="ImageIdentifier" oor:type="xs:string">
+							<value>%origin%/icons/image1</value>
+						</prop>
+						<!-- TODO: Replace it with your own toolbar button title. -->
+						<prop oor:name="Title" oor:type="xs:string">
+							<value>Sample Basic Extension Template</value>
+							<value xml:lang="zh-TW">Basic擴充套件範本</value>
+						</prop>
+						<prop oor:name="Target" oor:type="xs:string">
+							<value>_self</value>
+						</prop>
+					</node>
+				</node>
+				<!-- End of OpenOffice 4.x compatibility -->
+				<!-- Start of OpenOffice 3.x and LibreOffce compatibility -->
+				<node oor:name="m001" oor:op="replace">
+					<prop oor:name="Context" oor:type="xs:string">
+						<value></value>
+					</prop>
+					<!-- TODO: Replace SampleProject with your own project name. -->
+					<prop oor:name="URL" oor:type="xs:string">
+						<value>vnd.sun.star.script:SampleProject.MyModule.Main?language=Basic&amp;location=application</value>
+					</prop>
+					<prop oor:name="ImageIdentifier" oor:type="xs:string">
+						<value>%origin%/icons/image1</value>
+					</prop>
+					<!-- TODO: Replace it with your own toolbar button title. -->
+					<prop oor:name="Title" oor:type="xs:string">
+						<value>Sample Basic Extension Template</value>
+						<value xml:lang="zh-TW">Basic擴充套件範本</value>
+					</prop>
+					<prop oor:name="Target" oor:type="xs:string">
+						<value>_self</value>
+					</prop>
+				</node>
+				<!-- End of OpenOffice 3.x and LibreOffce compatibility -->
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/META-INF/manifest.xml
+++ b/sample-project/oxt/META-INF/manifest.xml
@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<manifest:manifest>
+  <!-- TODO: Replace SampleProject with your own project folder name. -->
+ <manifest:file-entry manifest:full-path="SampleProject/" manifest:media-type="application/vnd.sun.star.basic-library"/>
+ <manifest:file-entry manifest:full-path="pkg-desc/pkg-description.txt" manifest:media-type="application/vnd.sun.star.package-bundle-description"/>
+ <manifest:file-entry manifest:full-path="pkg-desc/pkg-description.zh-TW.txt" manifest:media-type="application/vnd.sun.star.package-bundle-description;locale=zh-TW"/>
+ <manifest:file-entry manifest:full-path="AddonConfiguration.xcs" manifest:media-type="application/vnd.sun.star.configuration-schema"/>
+ <manifest:file-entry manifest:full-path="AddonConfiguration.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Addons.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/BaseWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/BasicIDEWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/CalcWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/DrawWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/ImpressWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/MathWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/StartModuleWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+ <manifest:file-entry manifest:full-path="Office/UI/WriterWindowState.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
+</manifest:manifest>
--- a/sample-project/oxt/Office/UI/BaseWindowState.xcu
+++ b/sample-project/oxt/Office/UI/BaseWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="BaseWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/Office/UI/BasicIDEWindowState.xcu
+++ b/sample-project/oxt/Office/UI/BasicIDEWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="BasicIDEWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/Office/UI/CalcWindowState.xcu
+++ b/sample-project/oxt/Office/UI/CalcWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="CalcWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/Office/UI/DrawWindowState.xcu
+++ b/sample-project/oxt/Office/UI/DrawWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="DrawWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/Office/UI/ImpressWindowState.xcu
+++ b/sample-project/oxt/Office/UI/ImpressWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="ImpressWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/Office/UI/MathWindowState.xcu
+++ b/sample-project/oxt/Office/UI/MathWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="MathWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/Office/UI/StartModuleWindowState.xcu
+++ b/sample-project/oxt/Office/UI/StartModuleWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="StartModuleWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/Office/UI/WriterWindowState.xcu
+++ b/sample-project/oxt/Office/UI/WriterWindowState.xcu
@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oor:component-data xmlns:oor="http://openoffice.org/2001/registry"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ oor:name="WriterWindowState"
+ oor:package="org.openoffice.Office.UI">
+	<node oor:name="UIElements">
+		<node oor:name="States">
+			<node oor:name="private:resource/toolbar/addon_SampleProject.OfficeToolBar" oor:op="replace">
+				<prop oor:name="UIName" oor:type="xs:string">
+					<value>(Sample Project)</value>
+					<value xml:lang="zh-TW">（範例專案）</value>
+				</prop>
+			</node>
+		</node>
+	</node>
+</oor:component-data>
--- a/sample-project/oxt/SampleProject/DialogStrings_en_US.default
+++ b/sample-project/oxt/SampleProject/DialogStrings_en_US.default
--- a/sample-project/oxt/SampleProject/DialogStrings_en_US.properties
+++ b/sample-project/oxt/SampleProject/DialogStrings_en_US.properties
@ -0,0 +1,9 @@
+# Strings for Dialog Library SampleProject
+0.MyDialog.HelpText=
+1.MyDialog.Title=Dinner Choices
+2.MyDialog.Label1.HelpText=
+3.MyDialog.Label1.Label=Dinner:
+4.MenuList1.StringItemList=Beef
+5.MenuList1.StringItemList=Pork
+6.MenuList1.StringItemList=Chicken
+7.MenuList1.StringItemList=Fish
--- a/sample-project/oxt/SampleProject/DialogStrings_zh_TW.properties
+++ b/sample-project/oxt/SampleProject/DialogStrings_zh_TW.properties
@ -0,0 +1,9 @@
+# Strings for Dialog Library SampleProject
+0.MyDialog.HelpText=
+1.MyDialog.Title=\u9910\u9EDE\u9078\u64C7
+2.MyDialog.Label1.HelpText=
+3.MyDialog.Label1.Label=\u9910\u9EDE\uFF1A
+4.MenuList1.StringItemList=\u725B\u8089
+5.MenuList1.StringItemList=\u8C6C\u8089
+6.MenuList1.StringItemList=\u96DE\u8089
+7.MenuList1.StringItemList=\u9B5A\u8089
--- a/sample-project/oxt/SampleProject/MyDialog.xdl
+++ b/sample-project/oxt/SampleProject/MyDialog.xdl
@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE dlg:window PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "dialog.dtd">
+<dlg:window xmlns:dlg="http://openoffice.org/2000/dialog" xmlns:script="http://openoffice.org/2000/script" dlg:id="MyDialog" dlg:left="200" dlg:top="100" dlg:width="100" dlg:height="35" dlg:help-text="&amp;0.MyDialog.HelpText" dlg:closeable="true" dlg:moveable="true" dlg:title="&amp;1.MyDialog.Title">
+ <dlg:bulletinboard>
+  <dlg:text dlg:id="Label1" dlg:tab-index="0" dlg:left="5" dlg:top="6" dlg:width="45" dlg:height="8" dlg:help-text="&amp;2.MyDialog.Label1.HelpText" dlg:value="&amp;3.MyDialog.Label1.Label"/>
+  <dlg:menulist dlg:id="MenuList1" dlg:tab-index="1" dlg:left="50" dlg:top="4" dlg:width="45" dlg:height="12" dlg:spin="true">
+   <dlg:menupopup>
+    <dlg:menuitem dlg:value="&amp;4.MenuList1.StringItemList"/>
+    <dlg:menuitem dlg:value="&amp;5.MenuList1.StringItemList"/>
+    <dlg:menuitem dlg:value="&amp;6.MenuList1.StringItemList"/>
+    <dlg:menuitem dlg:value="&amp;7.MenuList1.StringItemList"/>
+   </dlg:menupopup>
+  </dlg:menulist>
+  <dlg:button dlg:id="CommandButton1" dlg:tab-index="2" dlg:left="5" dlg:top="19" dlg:width="40" dlg:height="12" dlg:default="true" dlg:button-type="ok"/>
+  <dlg:button dlg:id="CommandButton2" dlg:tab-index="3" dlg:left="55" dlg:top="19" dlg:width="40" dlg:height="12" dlg:button-type="cancel"/>
+ </dlg:bulletinboard>
+</dlg:window>
--- a/sample-project/oxt/SampleProject/MyModule.xba
+++ b/sample-project/oxt/SampleProject/MyModule.xba
@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE script:module PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "module.dtd">
+<script:module xmlns:script="http://openoffice.org/2000/script" script:name="MyModule" script:language="StarBasic">&apos; MyModule: The main module of the sample project
+&apos;   by imacat &lt;imacat@mail.imacat.idv.tw&gt;, 2017-08-01
+
+Option Explicit
+
+&apos; Main: The main program
+Sub Main
+	
+	MsgBox &quot;OK&quot;
+	
+End Sub
+</script:module>
--- a/sample-project/oxt/SampleProject/dialog.xlb
+++ b/sample-project/oxt/SampleProject/dialog.xlb
@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE library:library PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "library.dtd">
+<library:library xmlns:library="http://openoffice.org/2000/library" library:name="SampleProject" library:readonly="false" library:passwordprotected="false">
+ <library:element library:name="MyDialog"/>
+</library:library>
--- a/sample-project/oxt/SampleProject/script.xlb
+++ b/sample-project/oxt/SampleProject/script.xlb
@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE library:library PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "library.dtd">
+<library:library xmlns:library="http://openoffice.org/2000/library" library:name="SampleProject" library:readonly="false" library:passwordprotected="false">
+ <library:element library:name="MyModule"/>
+</library:library>
--- a/sample-project/oxt/description.xml
+++ b/sample-project/oxt/description.xml
@ -0,0 +1,38 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<description
+ xmlns="http://openoffice.org/extensions/description/2006"
+ xmlns:dep="http://openoffice.org/extensions/description/2006"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
+    <!-- TODO: Replace it with your own project project identifier. -->
+	<identifier value="com.example.officebasic.sampleproject"/>
+	<version value="@VERSION@"/>
+	<!-- <dependencies>
+		<OpenOffice.org-minimal-version value="2.1" dep:name="OpenOffice.org 2.1"/>
+	</dependencies> -->
+	<publisher>
+	    <!-- TODO: Replace it with your own name and URL.
+	        Remove xlink:href="…" if you don't have an URL for yourself. -->
+		<name xlink:href="http://www.example.com/">(Jane Doe)</name>
+		<name lang="zh-TW" xlink:href="http://www.example.com/">（陳小芬）</name>
+	</publisher>
+	<registration>
+		<simple-license accept-by="admin" default-license-id="ID0" suppress-on-update="true" >
+			<license-text xlink:href="registration/LICENSE" lang="en" license-id="ID0" />
+		</simple-license>
+	</registration>
+	<display-name>
+	    <!-- TODO: Replace it with your own project name. -->
+		<name>(Sample Project)</name>
+		<name lang="zh-TW">（範例專案）</name>
+	</display-name>
+	<!-- TODO: Replace it with your own project icon,
+	    or remove this <icon>…</icon> section entirely. -->
+	<icon>
+		<default xlink:href="icons/sampleproject.png" />
+	</icon>
+	<!-- TODO: Replace it with your own project update information URL,
+	    or remove this <update-information>…</update-information> section entirely. -->
+	<update-information>
+		<src xlink:href="http://update.example.com/officebasic/sampleproject.update.xml" />
+	</update-information>
+</description>
--- a/sample-project/oxt/icons/image1_16.bmp
+++ b/sample-project/oxt/icons/image1_16.bmp
--- a/sample-project/oxt/icons/image1_16h.bmp
+++ b/sample-project/oxt/icons/image1_16h.bmp
--- a/sample-project/oxt/icons/image1_26.bmp
+++ b/sample-project/oxt/icons/image1_26.bmp
--- a/sample-project/oxt/icons/image1_26h.bmp
+++ b/sample-project/oxt/icons/image1_26h.bmp
--- a/sample-project/oxt/icons/pokemongoiv.png
+++ b/sample-project/oxt/icons/pokemongoiv.png
--- a/sample-project/oxt/icons/team-leader-blanche.png
+++ b/sample-project/oxt/icons/team-leader-blanche.png
--- a/sample-project/oxt/icons/team-leader-candela.png
+++ b/sample-project/oxt/icons/team-leader-candela.png
--- a/sample-project/oxt/icons/team-leader-spark.png
+++ b/sample-project/oxt/icons/team-leader-spark.png
--- a/sample-project/oxt/icons/team-logo-instinct.png
+++ b/sample-project/oxt/icons/team-logo-instinct.png
--- a/sample-project/oxt/icons/team-logo-mystic.png
+++ b/sample-project/oxt/icons/team-logo-mystic.png
--- a/sample-project/oxt/icons/team-logo-valor.png
+++ b/sample-project/oxt/icons/team-logo-valor.png
--- a/sample-project/oxt/icons/unknown.png
+++ b/sample-project/oxt/icons/unknown.png
--- a/sample-project/oxt/pkg-desc/pkg-description.txt
+++ b/sample-project/oxt/pkg-desc/pkg-description.txt
@ -0,0 +1,4 @@
+SampleProject - A Sample OpenOffice Basic Extension Project Template
+Copyright (c) 2017 imacat 
+
+A Sample OpenOffice/LibreOffice Basic extension project template.
--- a/sample-project/oxt/pkg-desc/pkg-description.zh-TW.txt
+++ b/sample-project/oxt/pkg-desc/pkg-description.zh-TW.txt
@ -0,0 +1,4 @@
+SampleProject - OpenOffice Basic擴充套件專案範本
+版權所有 (c) 2017 依瑪貓
+
+OpenOffice/LibreOffice Basic擴充套件專案範本。
--- a/sample-project/oxt/registration/LICENSE
+++ b/sample-project/oxt/registration/LICENSE
@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.