mirror of
https://github.com/apache/poi.git
synced 2026-02-27 20:40:08 +08:00
replace svn refs
This commit is contained in:
parent
18fc855e66
commit
39e5ac2906
@ -60,9 +60,9 @@ Requires Java 1.8 or later.
|
||||
Contributing
|
||||
------------------
|
||||
|
||||
* Download and install svn or git, Java JDK 1.8+, and Apache Ant 1.8+ or Gradle
|
||||
* Download and install git, Java JDK 1.8+, and Apache Ant 1.8+ or Gradle
|
||||
|
||||
* Check out the code from svn or git
|
||||
* Check out the code from git
|
||||
|
||||
* Import the project into Eclipse or your favorite IDE
|
||||
|
||||
|
||||
@ -29,7 +29,7 @@ This release comes in source form:
|
||||
All release artifacts are accompanied by SHA checksums and PGP signatures
|
||||
that you can use to verify the authenticity of your download.
|
||||
The public key used for the PGP signature can be found at
|
||||
https://svn.apache.org/repos/asf/poi/tags/@RELEASE_TAG@/KEYS
|
||||
https://downloads.apache.org/poi/KEYS
|
||||
|
||||
About Apache POI
|
||||
-----------------------
|
||||
|
||||
@ -38,7 +38,7 @@
|
||||
<!-- TODO More about XDGF here! -->
|
||||
<p>Currently, HDGF provides a low-level, read-only api for
|
||||
accessing Visio documents. It also provides a
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hdgf/extractor/">way</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/src/main/java/org/apache/poi/hdgf/extractor/">way</a>
|
||||
to extract the textual content from a file.
|
||||
</p>
|
||||
<p>At this time, there is no <em>usermodel</em> api or similar,
|
||||
@ -50,7 +50,7 @@
|
||||
to get a feel for how Visio files are structured.</p>
|
||||
<p>To get a feel for the contents of a file, and to track down
|
||||
where data of interest is stored, HDGF comes with
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hdgf/dev/">VSDDumper</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/src/main/java/org/apache/poi/hdgf/dev/">VSDDumper</a>
|
||||
to print out the contents of the file. Users should also make
|
||||
use of
|
||||
<a href="https://web.archive.org/web/20071212220759/https://www.gnome.ru/projects/vsdump_en.html">vsdump</a>
|
||||
@ -58,8 +58,8 @@
|
||||
|
||||
<note>
|
||||
This code currently lives the
|
||||
<a href="https://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/">scratchpad area</a>
|
||||
of the POI SVN repository. To use this component, ensure
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/">scratchpad area</a>
|
||||
of the POI Git repository. To use this component, ensure
|
||||
you have the Scratchpad Jar on your classpath, or a dependency
|
||||
defined on the <em>poi-scratchpad</em> artifact - the main POI
|
||||
jar is not enough! See the
|
||||
|
||||
@ -96,15 +96,15 @@
|
||||
<p>
|
||||
Currently, there are only a handful of example programs using HWPF and XWPF
|
||||
available. They can be found in svn in the examples section, under
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hwpf">HWPF</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hwpf">HWPF</a>
|
||||
and
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xwpf">XWPF</a>.
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xwpf">XWPF</a>.
|
||||
Both HWPF and XWPF have fairly high levels of unit test coverage, which
|
||||
provides examples of using the various areas of functionality of both
|
||||
modules. These can be found in svn, under
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-scratchpad/src/test/java/org/apache/poi/hwpf">HWPF</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/src/test/java/org/apache/poi/hwpf">HWPF</a>
|
||||
and
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-ooxml/src/test/java/org/apache/poi/xwpf">XWPF</a>.
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-ooxml/src/test/java/org/apache/poi/xwpf">XWPF</a>.
|
||||
Contributions of more examples, whether inspired by the unit tests or
|
||||
not, would be most welcomed!
|
||||
</p>
|
||||
|
||||
@ -79,9 +79,9 @@ document.</p>
|
||||
|
||||
<section><title>Further Examples</title>
|
||||
<p>For now, there are a limited number of XWPF examples in the
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xwpf">Examples Package</a>.
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xwpf">Examples Package</a>.
|
||||
Beyond those, the best source of additional examples is in the unit
|
||||
tests. <a href="https://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/test/java/org/apache/poi/xwpf/">
|
||||
tests. <a href="https://github.com/apache/poi/tree/trunk/poi-ooxml/src/test/java/org/apache/poi/xwpf/">
|
||||
Browse the XWPF unit tests.</a>
|
||||
</p>
|
||||
</section>
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
<body>
|
||||
<p>HWPF is still in early development. It is in the <a
|
||||
href="https://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/">
|
||||
href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/">
|
||||
scratchpad section of the SVN.</a> You will need to ensure you
|
||||
either have a recent SVN checkout, or a recent SVN nightly build
|
||||
(including the scratchpad jar!)</p>
|
||||
@ -80,7 +80,7 @@ do end up with macros in them.</p>
|
||||
<section><title>Further Examples</title>
|
||||
<p>For now, the best source of additional examples is in the unit
|
||||
tests. <a
|
||||
href="https://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/test/java/org/apache/poi/hwpf/">
|
||||
href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/src/test/java/org/apache/poi/hwpf/">
|
||||
Browse the HWPF unit tests.</a>
|
||||
</p>
|
||||
</section>
|
||||
|
||||
@ -51,8 +51,8 @@
|
||||
|
||||
<note>
|
||||
This code currently lives the
|
||||
<a href="https://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/">scratchpad area</a>
|
||||
of the POI SVN repository. To use this component, ensure
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/">scratchpad area</a>
|
||||
of the POI Git repository. To use this component, ensure
|
||||
you have the Scratchpad Jar on your classpath, or a dependency
|
||||
defined on the <em>poi-scratchpad</em> artifact - the main POI
|
||||
jar is not enough! See the
|
||||
@ -190,7 +190,7 @@ for(Attachment attach : msg.getAttachments()) {
|
||||
|
||||
<p>To get a feel for the contents of a file, and to track down
|
||||
where data of interest is stored, HMEF comes with
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hmef/dev/">HMEFDumper</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/src/main/java/org/apache/poi/hmef/dev/">HMEFDumper</a>
|
||||
to print out the contents of the file.</p>
|
||||
</section>
|
||||
|
||||
|
||||
@ -189,7 +189,7 @@ PL 62 1a 00 00 48 00 00 00 // PL from: 1a62 (6754), len: 48 (72)
|
||||
<p>Type 8 has 7 2 byte unsigned ints, then a pair of 4 byte
|
||||
unsigned ints for each entry.</p>
|
||||
<p>Type 12 holds hyperlinks, and is very much more complex.
|
||||
See <a href="https://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hpbf/model/qcbits/QCPLCBit.java?view=markup"><code>org.apache.poi.hpbf.model.qcbits.QCPLCBit</code></a>
|
||||
See <a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/src/main/java/org/apache/poi/hpbf/model/qcbits/QCPLCBit.java?view=markup"><code>org.apache.poi.hpbf.model.qcbits.QCPLCBit</code></a>
|
||||
for our best guess as to how the contents match up.</p>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
@ -64,8 +64,8 @@
|
||||
|
||||
<note>
|
||||
This code currently lives the
|
||||
<a href="https://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/">scratchpad area</a>
|
||||
of the POI SVN repository. To use this component, ensure
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/">scratchpad area</a>
|
||||
of the POI Git repository. To use this component, ensure
|
||||
you have the Scratchpad Jar on your classpath, or a dependency
|
||||
defined on the <em>poi-scratchpad</em> artifact - the main POI
|
||||
jar is not enough! See the
|
||||
|
||||
@ -40,13 +40,13 @@
|
||||
<p>There is an example MSG textual renderer, which shows how to access the
|
||||
common parts such as sender, subject, message body and examples. This is
|
||||
in the
|
||||
<a href="https://svn.apache.org/viewvc/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hsmf/">HSMF examples area</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hsmf/">HSMF examples area</a>
|
||||
of SVN. You may also wish to look at the unit tests for more use guides.</p>
|
||||
|
||||
<note>
|
||||
This code currently lives the
|
||||
<a href="https://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java">scratchpad area</a>
|
||||
of the POI SVN repository. To use this component, ensure
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/src/main/java">scratchpad area</a>
|
||||
of the POI Git repository. To use this component, ensure
|
||||
you have the Scratchpad Jar on your classpath, or a dependency
|
||||
defined on the <em>poi-scratchpad</em> artifact - the main POI
|
||||
jar is not enough! See the
|
||||
|
||||
@ -385,8 +385,8 @@
|
||||
<section><title>Examples</title>
|
||||
<p>
|
||||
Small sample programs using the POI API are available in the
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples">src/examples</a>
|
||||
(<a href="https://svn.apache.org/viewvc/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples">viewvc</a>) directory of the source distribution.
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples">src/examples</a>
|
||||
(<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples">viewvc</a>) directory of the source distribution.
|
||||
</p>
|
||||
<p>
|
||||
All of the examples are included in POI distributions as a poi-examples artifact.
|
||||
@ -408,7 +408,7 @@
|
||||
<p>
|
||||
See <a href="poi-ruby.html">POI Ruby Bindings</a> and other code in the
|
||||
<a
|
||||
href="https://svn.apache.org/repos/asf/poi/trunk/src/contrib/">poi-contrib module</a>
|
||||
href="https://github.com/apache/poi/tree/trunk/src/contrib/">poi-contrib module</a>
|
||||
</p>
|
||||
</section>
|
||||
</body>
|
||||
|
||||
@ -118,7 +118,7 @@
|
||||
from org.apache.poi.ss.usermodel import <a href="../apidocs/dev/org/apache/poi/ss/usermodel/WorkbookFactory.html">WorkbookFactory</a>, <a href="../apidocs/dev/org/apache/poi/ss/usermodel/DataFormatter.html">DataFormatter</a>
|
||||
|
||||
# Read the contents of the workbook
|
||||
wb = WorkbookFactory.create(File('<a href="https://svn.apache.org/viewvc/poi/trunk/test-data/spreadsheet/SampleSS.xlsx">SampleSS.xlsx</a>'))
|
||||
wb = WorkbookFactory.create(File('<a href="https://github.com/apache/poi/tree/trunk/test-data/spreadsheet/SampleSS.xlsx">SampleSS.xlsx</a>'))
|
||||
formatter = DataFormatter()
|
||||
for i, sheet in enumerate(wb, start=1):
|
||||
print('Sheet %d of %d: %s'.format(i, wb.numberOfSheets, sheet.sheetName))
|
||||
@ -168,7 +168,7 @@
|
||||
import scala.collection.JavaConversions._
|
||||
|
||||
// Read the contents of the workbook
|
||||
val workbook = WorkbookFactory.create(new File("<a href="https://svn.apache.org/viewvc/poi/trunk/test-data/spreadsheet/SampleSS.xlsx">SampleSS.xlsx</a>"))
|
||||
val workbook = WorkbookFactory.create(new File("<a href="https://github.com/apache/poi/tree/trunk/test-data/spreadsheet/SampleSS.xlsx">SampleSS.xlsx</a>"))
|
||||
val formatter = new DataFormatter()
|
||||
for {
|
||||
// Iterate and print the sheets
|
||||
|
||||
@ -51,8 +51,8 @@
|
||||
</section>
|
||||
<section><title>Subversion</title>
|
||||
<p>
|
||||
The POI-Ruby module sits under the POI <a href="https://svn.apache.org/repos/asf/poi/trunk/src/contrib/poi-ruby/">Subversion</a>
|
||||
<a href="https://svn.apache.org/viewvc/poi/trunk/src/contrib/poi-ruby/">(viewvc)</a>. Running <em>make</em>
|
||||
The POI-Ruby module sits under the POI <a href="https://github.com/apache/poi/tree/trunk/src/contrib/poi-ruby/">Subversion</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/src/contrib/poi-ruby/">(viewvc)</a>. Running <em>make</em>
|
||||
inside that directory will create a loadable ruby extension <em>poi4r.so</em> in the release subdirectory. Tests
|
||||
are in the <em>tests/</em> subdirectory, and should be run from the <em>poi-ruby</em> directory. Please read the tests to figure out the usage.
|
||||
</p>
|
||||
|
||||
@ -619,7 +619,7 @@
|
||||
}
|
||||
]]></source>
|
||||
<p>For an example of an in-place change to one stream within a file, you can see the example
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hpsf/ModifyDocumentSummaryInformation.java">
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hpsf/ModifyDocumentSummaryInformation.java">
|
||||
org/apache/poi/hpsf/examples/ModifyDocumentSummaryInformation.java
|
||||
</a>
|
||||
</p>
|
||||
|
||||
@ -43,8 +43,8 @@
|
||||
</ul>
|
||||
<note>
|
||||
This code currently lives the
|
||||
<a href="https://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/">scratchpad area</a>
|
||||
of the POI SVN repository. To use this component, ensure
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-scratchpad/">scratchpad area</a>
|
||||
of the POI Git repository. To use this component, ensure
|
||||
you have the Scratchpad Jar on your classpath, or a dependency
|
||||
defined on the <em>poi-scratchpad</em> artifact - the main POI
|
||||
jar is not enough! See the
|
||||
|
||||
@ -31,7 +31,7 @@
|
||||
<title>Rendering slideshows, WMF, EMF and EMF+</title>
|
||||
<p>
|
||||
For rendering slideshow (HSLF/XSLF), WMF, EMF and EMF+ pictures, POI provides an utility class
|
||||
<a href="https://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/util/PPTX2PNG.java?view=markup">
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/util/PPTX2PNG.java?view=markup">
|
||||
PPTX2PNG</a>:
|
||||
</p>
|
||||
|
||||
|
||||
@ -30,8 +30,8 @@
|
||||
<section><title>XSLF Cookbook</title>
|
||||
<p>
|
||||
This page offers a short introduction into the XSLF API. More examples can be found in the
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xslf/">XSLF Examples</a>
|
||||
in the POI SVN repository.
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xslf/">XSLF Examples</a>
|
||||
in the POI Git repository.
|
||||
</p>
|
||||
<note>
|
||||
Please note that XSLF is still in early development and is a subject to incompatible changes in a future release.
|
||||
|
||||
@ -39,7 +39,7 @@
|
||||
or
|
||||
BusinessPlan -xlsx
|
||||
</source>
|
||||
<p>All sample source is available in <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/">SVN</a></p>
|
||||
<p>All sample source is available in <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/">SVN</a></p>
|
||||
<p>In addition, there are a handful of
|
||||
<a href="#hssf-only">HSSF only</a> and
|
||||
<a href="#xssf-only">XSSF only</a> examples as well.
|
||||
@ -73,7 +73,7 @@
|
||||
<anchor id="ss-common" />
|
||||
<anchor id="business-plan" />
|
||||
<section><title>Business Plan</title>
|
||||
<p> The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/BusinessPlan.java">BusinessPlan</a>
|
||||
<p> The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/BusinessPlan.java">BusinessPlan</a>
|
||||
application creates a sample business plan with three phases, weekly iterations and time highlighting. Demonstrates advanced cell formatting
|
||||
(number and date formats, alignments, fills, borders) and various settings for organizing data in a sheet (freezed panes, grouped rows).
|
||||
</p>
|
||||
@ -82,7 +82,7 @@
|
||||
|
||||
<anchor id="calendar" />
|
||||
<section><title>Calendar</title>
|
||||
<p> The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/CalendarDemo.java">Calendar</a>
|
||||
<p> The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/CalendarDemo.java">Calendar</a>
|
||||
demo creates a multi sheet calendar. Each month is on a separate sheet.
|
||||
</p>
|
||||
<figure src="images/calendar.jpg" alt="calendar demo"/>
|
||||
@ -90,7 +90,7 @@
|
||||
|
||||
<anchor id="loan-calculator" />
|
||||
<section><title>Loan Calculator</title>
|
||||
<p> The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/LoanCalculator.java">LoanCalculator</a>
|
||||
<p> The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/LoanCalculator.java">LoanCalculator</a>
|
||||
demo creates a simple loan calculator. Demonstrates advance usage of cell formulas and named ranges.
|
||||
</p>
|
||||
<figure src="images/loancalc.jpg" alt="loan calculator demo"/>
|
||||
@ -98,7 +98,7 @@
|
||||
|
||||
<anchor id="timesheet" />
|
||||
<section><title>Timesheet</title>
|
||||
<p> The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/TimesheetDemo.java">Timesheet</a>
|
||||
<p> The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/TimesheetDemo.java">Timesheet</a>
|
||||
demo creates a weekly timesheet with automatic calculation of total hours. Demonstrates advance usage of cell formulas.
|
||||
</p>
|
||||
<figure src="images/timesheet.jpg" alt="timesheet demo"/>
|
||||
@ -106,7 +106,7 @@
|
||||
|
||||
<anchor id="conditional-formats" />
|
||||
<section><title>Conditional Formats</title>
|
||||
<p> The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ConditionalFormats.java">ConditionalFormats</a>
|
||||
<p> The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ConditionalFormats.java">ConditionalFormats</a>
|
||||
demo is a collection of short examples showing what you can do with Excel conditional formatting in POI:
|
||||
</p>
|
||||
<ul>
|
||||
@ -124,23 +124,23 @@
|
||||
|
||||
<anchor id="common-formulas" />
|
||||
<section><title>Formula Examples</title>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula/CalculateMortgage.java">CalculateMortgage</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula/CalculateMortgage.java">CalculateMortgage</a>
|
||||
example demonstrates a simple user-defined function to calculate
|
||||
principal and interest.</p>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula/CheckFunctionsSupported.java">CheckFunctionsSupported</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula/CheckFunctionsSupported.java">CheckFunctionsSupported</a>
|
||||
example shows how to test what functions and formulas aren't
|
||||
supported from a given file.</p>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula/SettingExternalFunction.java">SettingExternalFunction</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula/SettingExternalFunction.java">SettingExternalFunction</a>
|
||||
example demonstrates how to use externally provided (third-party)
|
||||
formula add-ins.</p>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula/UserDefinedFunctionExample.java">UserDefinedFunctionExample</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula/UserDefinedFunctionExample.java">UserDefinedFunctionExample</a>
|
||||
example demonstrates how to invoke a User Defined Function for a
|
||||
given Workbook instance using POI's UDFFinder implementation.</p>
|
||||
</section>
|
||||
|
||||
<anchor id="add-dimensioned-image" />
|
||||
<section><title>Add Dimensioned Image</title>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/AddDimensionedImage.java">AddDimensionedImage</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/AddDimensionedImage.java">AddDimensionedImage</a>
|
||||
example demonstrates how to add an image to a worksheet and set that
|
||||
images size to a specific number of millimetres irrespective of the
|
||||
width of the columns or height of the rows.</p>
|
||||
@ -148,26 +148,26 @@
|
||||
|
||||
<anchor id="aligned-cells" />
|
||||
<section><title>Aligned Cells</title>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/AligningCells.java">AligningCells</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/AligningCells.java">AligningCells</a>
|
||||
example demonstrates how various alignment options work.</p>
|
||||
</section>
|
||||
|
||||
<anchor id="cell-style-details" />
|
||||
<section><title>Cell Style Details</title>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/CellStyleDetails.java">CellStyleDetails</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/CellStyleDetails.java">CellStyleDetails</a>
|
||||
example demonstrates how to read excel styles for cells.</p>
|
||||
</section>
|
||||
|
||||
<anchor id="linked-dropdown" />
|
||||
<section><title>Linked Dropdown Lists</title>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/LinkedDropDownLists.java">LinkedDropDownLists</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/LinkedDropDownLists.java">LinkedDropDownLists</a>
|
||||
example demonstrates one technique that may be used to create linked
|
||||
or dependent drop down lists.</p>
|
||||
</section>
|
||||
|
||||
<anchor id="performance-test" />
|
||||
<section><title>Common SS Performance Test</title>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/SSPerformanceTest.java">SSPerformanceTest</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/SSPerformanceTest.java">SSPerformanceTest</a>
|
||||
example provides a way to create simple example files of varying
|
||||
sizes, and to calculate how long they take. Useful for benchmarking
|
||||
your system, and to also test if slow performance is due to Apache
|
||||
@ -176,14 +176,14 @@
|
||||
|
||||
<anchor id="to-html" />
|
||||
<section><title>ToHtml</title>
|
||||
<p> The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/html/ToHtml.java">ToHtml</a>
|
||||
<p> The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/html/ToHtml.java">ToHtml</a>
|
||||
example shows how to display a spreadsheet in HTML using the classes for spreadsheet display.
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<anchor id="to-csv" />
|
||||
<section><title>ToCSV</title>
|
||||
<p>The <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ToCSV.java">ToCSV</a>
|
||||
<p>The <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ToCSV.java">ToCSV</a>
|
||||
example demonstrates <em>one</em> way to convert an Excel spreadsheet into a CSV file.
|
||||
</p>
|
||||
</section>
|
||||
@ -192,82 +192,82 @@
|
||||
<anchor id="hssf-only" />
|
||||
<section><title>HSSF-only Examples</title>
|
||||
<p>All the HSSF-only examples can be found in
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/">SVN</a></p>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/">SVN</a></p>
|
||||
<ul>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/CellComments.java">CellComments</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/HyperlinkFormula.java">HyperlinkFormula</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/EventExample.java">EventExample</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/OfficeDrawingWithGraphics.java">OfficeDrawingWithGraphics</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/CreateDateCells.java">CreateDateCells</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/NewWorkbook.java">NewWorkbook</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/EmeddedObjects.java">EmeddedObjects</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/Hyperlinks.java">Hyperlinks</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/OfficeDrawing.java">OfficeDrawing</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/HSSFReadWrite.java">HSSFReadWrite</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/NewSheet.java">NewSheet</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/SplitAndFreezePanes.java">SplitAndFreezePanes</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/InCellLists.java">InCellLists</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/RepeatingRowsAndColumns.java">RepeatingRowsAndColumns</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/MergedCells.java">MergedCells</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/CellTypes.java">CellTypes</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/ZoomSheet.java">ZoomSheet</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/ReadWriteWorkbook.java">ReadWriteWorkbook</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/CreateCells.java">CreateCells</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/Alignment.java">Alignment</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/FrillsAndFills.java">FrillsAndFills</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/AddDimensionedImage.java">AddDimensionedImage</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/Borders.java">Borders</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/NewLinesInCells.java">NewLinesInCells</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/WorkingWithFonts.java">WorkingWithFonts</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/BigExample.java">BigExample</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/Outlines.java">Outlines</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/eventusermodel/XLS2CSVmra.java">XLS2CSVmra</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/CellComments.java">CellComments</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/HyperlinkFormula.java">HyperlinkFormula</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/EventExample.java">EventExample</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/OfficeDrawingWithGraphics.java">OfficeDrawingWithGraphics</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/CreateDateCells.java">CreateDateCells</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/NewWorkbook.java">NewWorkbook</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/EmeddedObjects.java">EmeddedObjects</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/Hyperlinks.java">Hyperlinks</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/OfficeDrawing.java">OfficeDrawing</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/HSSFReadWrite.java">HSSFReadWrite</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/NewSheet.java">NewSheet</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/SplitAndFreezePanes.java">SplitAndFreezePanes</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/InCellLists.java">InCellLists</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/RepeatingRowsAndColumns.java">RepeatingRowsAndColumns</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/MergedCells.java">MergedCells</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/CellTypes.java">CellTypes</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/ZoomSheet.java">ZoomSheet</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/ReadWriteWorkbook.java">ReadWriteWorkbook</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/CreateCells.java">CreateCells</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/Alignment.java">Alignment</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/FrillsAndFills.java">FrillsAndFills</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/AddDimensionedImage.java">AddDimensionedImage</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/Borders.java">Borders</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/NewLinesInCells.java">NewLinesInCells</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/WorkingWithFonts.java">WorkingWithFonts</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/BigExample.java">BigExample</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/Outlines.java">Outlines</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/eventusermodel/XLS2CSVmra.java">XLS2CSVmra</a></li>
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<anchor id="xssf-only" />
|
||||
<section><title>XSSF-only Examples</title>
|
||||
<p>All the XSSF-only examples can be found in
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/">SVN</a></p>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/">SVN</a></p>
|
||||
<ul>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CellComments.java">CellComments</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/HeadersAndFooters.java">HeadersAndFooters</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreateUserDefinedDataFormats.java">CreateUserDefinedDataFormats</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreatePivotTable.java">CreatePivotTable</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreatePivotTable2.java">CreatePivotTable2</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/FillsAndColors.java">FillsAndColors</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithBorders.java">WorkingWithBorders</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/BigGridDemo.java">BigGridDemo</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreateTable.java">CreateTable</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CalendarDemo.java">CalendarDemo</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/AligningCells.java">AligningCells</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/SplitAndFreezePanes.java">SplitAndFreezePanes</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithPageSetup.java">WorkingWithPageSetup</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithPictures.java">WorkingWithPictures</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/MergingCells.java">MergingCells</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CustomXMLMapping.java">CustomXMLMapping</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/SelectedSheet.java">SelectedSheet</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/EmbeddedObjects.java">EmbeddedObjects</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkbookProperties.java">WorkbookProperties</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/NewLinesInCells.java">NewLinesInCells</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/Outlining.java">Outlining</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreateCell.java">CreateCell</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/IterateCells.java">IterateCells</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/BarChart.java">BarChart</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/BarAndLineChart.java">BarAndLineChart</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/LineChart.java">LineChart</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/ScatterChart.java">ScatterChart</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithFonts.java">WorkingWithFonts</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/HyperlinkExample.java">HyperlinkExample</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/ShiftRows.java">ShiftRows</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithRichText.java">WorkingWithRichText</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/FitSheetToOnePage.java">FitSheetToOnePage</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/HybridStreaming.java">HybridStreaming</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/Outlining.java">Outlining (SXSSF output)</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/DeferredGeneration.java">DeferredGeneration (SXSSF output)</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/SavePasswordProtectedXlsx.java">SavePasswordProtectedXlsx (SXSSF output)</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">XLSX2CSV (streaming read)</a></li>
|
||||
<li><a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/FromHowTo.java">FromHowTo (streaming read)</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CellComments.java">CellComments</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/HeadersAndFooters.java">HeadersAndFooters</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreateUserDefinedDataFormats.java">CreateUserDefinedDataFormats</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreatePivotTable.java">CreatePivotTable</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreatePivotTable2.java">CreatePivotTable2</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/FillsAndColors.java">FillsAndColors</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithBorders.java">WorkingWithBorders</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/BigGridDemo.java">BigGridDemo</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreateTable.java">CreateTable</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CalendarDemo.java">CalendarDemo</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/AligningCells.java">AligningCells</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/SplitAndFreezePanes.java">SplitAndFreezePanes</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithPageSetup.java">WorkingWithPageSetup</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithPictures.java">WorkingWithPictures</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/MergingCells.java">MergingCells</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CustomXMLMapping.java">CustomXMLMapping</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/SelectedSheet.java">SelectedSheet</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/EmbeddedObjects.java">EmbeddedObjects</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkbookProperties.java">WorkbookProperties</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/NewLinesInCells.java">NewLinesInCells</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/Outlining.java">Outlining</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/CreateCell.java">CreateCell</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/IterateCells.java">IterateCells</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/BarChart.java">BarChart</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/BarAndLineChart.java">BarAndLineChart</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/LineChart.java">LineChart</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/ScatterChart.java">ScatterChart</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithFonts.java">WorkingWithFonts</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/HyperlinkExample.java">HyperlinkExample</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/ShiftRows.java">ShiftRows</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/WorkingWithRichText.java">WorkingWithRichText</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/usermodel/FitSheetToOnePage.java">FitSheetToOnePage</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/HybridStreaming.java">HybridStreaming</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/Outlining.java">Outlining (SXSSF output)</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/DeferredGeneration.java">DeferredGeneration (SXSSF output)</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/SavePasswordProtectedXlsx.java">SavePasswordProtectedXlsx (SXSSF output)</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">XLSX2CSV (streaming read)</a></li>
|
||||
<li><a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/FromHowTo.java">FromHowTo (streaming read)</a></li>
|
||||
</ul>
|
||||
</section>
|
||||
</body>
|
||||
|
||||
@ -96,7 +96,7 @@ workbooks then you need to have the following jars in your path:</p>
|
||||
to integrate a worksheet into an app, you may want to know that it's going to work before
|
||||
you actually try to write that code. ExcelAnt helps with that.</p>
|
||||
|
||||
<p>Consider the <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/excelant/simple-mortgage-calculation.xls">mortgage-calculation.xls</a>
|
||||
<p>Consider the <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/excelant/simple-mortgage-calculation.xls">mortgage-calculation.xls</a>
|
||||
file found in the Examples (link broken / file is missing). This sheet is shown below:</p>
|
||||
|
||||
<figure src="images/simple-xls-with-function.jpg" alt="mortgage calculation spreadsheet"/>
|
||||
|
||||
@ -284,7 +284,7 @@ method (sheet.removeRow(hssfrow)) and create objects just as you
|
||||
would if creating a new xls. When you are done modifying cells just
|
||||
call workbook.write(outputstream) just as you did above.</p>
|
||||
<p>An example of this can be seen in
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/HSSFReadWrite.java">org.apache.poi.hssf.usermodel.examples.HSSFReadWrite</a>.</p>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/usermodel/HSSFReadWrite.java">org.apache.poi.hssf.usermodel.examples.HSSFReadWrite</a>.</p>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
@ -469,7 +469,7 @@ some of the rows or cells. It can be found at
|
||||
<code>/poi-examples/src/main/java/org/apache/poi/examples/hssf/eventusermodel/XLS2CSVmra.java</code>,
|
||||
and may be called on the command line, or from within your own code.
|
||||
The latest version is always available from
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/eventusermodel/">subversion</a>.
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/hssf/eventusermodel/">subversion</a>.
|
||||
</p>
|
||||
<p>
|
||||
<em>In POI versions before 3.0.3, this code lived in the scratchpad section.
|
||||
@ -503,7 +503,7 @@ The latest version is always available from
|
||||
file, which you will then pass to SAX.</p>
|
||||
<p>This example shows how to get at a single known sheet, or at
|
||||
all sheets in the file. It is based on the example in
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/FromHowTo.java">svn
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/FromHowTo.java">svn
|
||||
poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/FromHowTo.java</a></p>
|
||||
<source><![CDATA[
|
||||
import java.io.InputStream;
|
||||
@ -627,9 +627,9 @@ public class ExampleEventUserModel {
|
||||
For a fuller example, including support for fetching number formatting
|
||||
information and applying it to numeric cells (eg to format dates or
|
||||
percentages), please see
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">the XLSX2CSV example in svn</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">the XLSX2CSV example in svn</a>
|
||||
</p>
|
||||
<p>An example is also <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/HybridStreaming.java">provided</a>
|
||||
<p>An example is also <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/streaming/HybridStreaming.java">provided</a>
|
||||
showing how to combine the user API and the SAX API by doing a streaming parse
|
||||
of larger worksheets and a traditional user-model parse of the rest of a workbook.</p>
|
||||
</section>
|
||||
|
||||
@ -55,7 +55,7 @@
|
||||
</li>
|
||||
<li>
|
||||
For reading very huge files, take a look at the sample
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">XLSX2CSV</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">XLSX2CSV</a>
|
||||
which shows how you can read a file in streaming fashion (again with some limitations on what information you
|
||||
can read out of the file, but there are ways to get at most of it if necessary).
|
||||
</li>
|
||||
|
||||
@ -2197,7 +2197,7 @@ the data to populate another drop down list.
|
||||
sheetCF.addConditionalFormatting(regions, cfRules);
|
||||
</source>
|
||||
<p> See more examples on Excel conditional formatting in
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ConditionalFormats.java">ConditionalFormats.java</a>
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ConditionalFormats.java">ConditionalFormats.java</a>
|
||||
</p>
|
||||
|
||||
</section>
|
||||
|
||||
@ -406,7 +406,7 @@ cell: Sheet1!B4
|
||||
returns value: org.apache.poi.ss.usermodel.CellValue [790.7936267415464]
|
||||
]]></source>
|
||||
<p>That is it! Now you can create Java code and register it, allowing your POI based appliction to run spreadsheets that previously were inaccessible.</p>
|
||||
<p>This example can be found in the <a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula">poi-examples/src/main/java/org/apache/poi/examples/ss/formula</a> folder in the source.</p>
|
||||
<p>This example can be found in the <a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/formula">poi-examples/src/main/java/org/apache/poi/examples/ss/formula</a> folder in the source.</p>
|
||||
</section>
|
||||
</section>
|
||||
</body>
|
||||
|
||||
@ -131,7 +131,7 @@
|
||||
Ideally, patches should be submitted early and often. This is for
|
||||
two key reasons. Firstly, it's much easier to review smaller patches
|
||||
than large ones. This means that smaller patches are much more likely
|
||||
to be applied to SVN in a timely fashion. Secondly, by sending in your
|
||||
to be applied to Git in a timely fashion. Secondly, by sending in your
|
||||
patches earlier rather than later, it's much easier to get feedback
|
||||
on your coding and direction. If you've missed an easier way to do something,
|
||||
or are duplicating some (probably hidden) existing code, or taking things
|
||||
|
||||
@ -123,7 +123,7 @@
|
||||
First make sure that Java is set up properly and that you can execute the 'javac' executable in your shell.
|
||||
</p>
|
||||
<p>
|
||||
Next, open Eclipse and create either a local SVN repository, or a copy of the Git repository,
|
||||
Next, open Eclipse and create a copy of the Git repository,
|
||||
and import the project into Eclipse.
|
||||
</p>
|
||||
<p>
|
||||
|
||||
@ -52,21 +52,13 @@
|
||||
<a href="https://www.apache.org/dev/version-control.html">version control page.</a>
|
||||
</p>
|
||||
|
||||
<p>Apache POI uses <a href="https://subversion.apache.org">Subversion</a> as its version control system,
|
||||
but also has a read-only git mirror
|
||||
</p>
|
||||
|
||||
<p><strong>NOTE</strong>: When checking out a subproject using
|
||||
subversion, either perform a sparse checkout or check out
|
||||
the trunk or a single branch or tag to avoid filling up
|
||||
your hard-disk and wasting bandwidth.
|
||||
<p>Apache POI uses Git as its version control system. We switch from Subversion to Git
|
||||
in July 2025.
|
||||
</p>
|
||||
|
||||
<ul>
|
||||
<li>For read only access to the latest Apache POI code, please use
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/">https://svn.apache.org/repos/asf/poi/trunk/</a></li>
|
||||
<li>To browse the svn repository in your web browser, please use
|
||||
<a href="https://svn.apache.org/viewvc/poi/">ViewVC</a></li>
|
||||
<li>For access to the latest Apache POI code, please use
|
||||
<a href="https://github.com/apache/poi/tree/trunk/">https://github.com/apache/poi/tree/trunk/</a></li>
|
||||
</ul>
|
||||
|
||||
<p>If you are not a <em>Committer</em>, but you want to submit patches
|
||||
@ -76,158 +68,12 @@
|
||||
</section>
|
||||
<section><title>Git access to POI sources</title>
|
||||
<p>
|
||||
The master source repository for Apache POI is the Subversion
|
||||
one listed above. To support those users and developers who prefer
|
||||
to use the Git tooling, read-only access to the POI source tree is
|
||||
also available via Git. The Git mirrors normally track SVN to
|
||||
within a few minutes.
|
||||
The trunk source repository for Apache POI is in gitbox.apache.org.
|
||||
The GitHub mirror can be used to access the repo too (https://github.com/apache/poi).
|
||||
You can create PRs and issues using GitHub, if you like.
|
||||
</p>
|
||||
<p>
|
||||
The official read-only Git repository for Apache POI is available
|
||||
from <a href="https://git.apache.org/">git.apache.org/</a> .
|
||||
The Git Clone URL is: <a href="git://git.apache.org/poi.git">git://git.apache.org/poi.git</a>
|
||||
and Https Clone URL: <a href="https://git.apache.org/poi.git">https://git.apache.org/poi.git</a> .
|
||||
Please see the <a href="https://git.apache.org/">Git at
|
||||
Apache</a> page for more details on the service.
|
||||
</p>
|
||||
<p>
|
||||
In addition to the <a href="https://git.apache.org/">git.apache.org</a>
|
||||
repository, changes are also mirrored in near-realtime to GitHub.
|
||||
The GitHub repository is available at
|
||||
<a href="https://github.com/apache/poi">https://github.com/apache/poi</a> .
|
||||
Please note that the GitHub repository is read-only, but pull requests sent
|
||||
to it will result in an email being sent to the mailing list. A Git-formatted
|
||||
patch added to Bugzilla is generally preferred though, as it can be tracked
|
||||
along with all the other contributions. Please see the
|
||||
<a href="site:guidelines">contribution guidelines</a> for more
|
||||
information on getting involved in the project.</p>
|
||||
</section>
|
||||
<section><title>Using Git via the SVN-Git bridge</title>
|
||||
<section><title>General information</title>
|
||||
<p>
|
||||
Git provides a nice functionality "git-svn" which allows to read the history
|
||||
of a Subversion repository and convert it into a full Git repository. This
|
||||
will keep information from the SVN revisions so that the Git repository can
|
||||
be updated with newer revisions from Subversion as well as allowing to push
|
||||
commits from Git "upstream" into the Subversion repository. See the
|
||||
<a href="https://www.kernel.org/pub/software/scm/git/docs/git-svn.html">
|
||||
official documentation</a> for more details.
|
||||
</p>
|
||||
</section>
|
||||
<section><title>Set up the repository</title>
|
||||
<p>
|
||||
The git-svn functionality is provided as a set of sub-commands to
|
||||
"git svn". To start retrieving information from SVN and create the
|
||||
initial Git repository run the following command:
|
||||
|
||||
</p>
|
||||
<source>
|
||||
git svn clone https://svn.apache.org/repos/asf/poi/trunk poisvngit --revision <a href="https://svn.apache.org/viewvc?view=revision&revision=1732982">1732982</a>:HEAD
|
||||
</source>
|
||||
<p>
|
||||
Running without <code>--revision from:HEAD</code> will run for a long time and will retrieve the full version history of
|
||||
the Subversion repository. If you need more repository history, change the <code>from</code> revision to an
|
||||
<a href="https://svn.apache.org/viewvc/poi/tags/">earlier release</a> or omit the <code>--revision</code>
|
||||
specifier altogether.
|
||||
</p>
|
||||
<p>
|
||||
When this finishes you have a Git repository whose "master" branch
|
||||
mirrors the SVN "trunk".
|
||||
<br/>
|
||||
From here you can use the full power of Git, i.e. quick branching,
|
||||
rebasing, merging, ...
|
||||
<br/>
|
||||
See below for some common usage hints.
|
||||
</p>
|
||||
</section>
|
||||
<section><title>Fetching newer SVN revisions</title>
|
||||
<p>
|
||||
In order to fetch the latest SVN revisions, you need to "rebase" onto
|
||||
the SVN trunk:
|
||||
</p>
|
||||
<source>
|
||||
git checkout master
|
||||
git svn rebase
|
||||
</source>
|
||||
<p>
|
||||
This will fetch the latest changes from Subversion and will rebase
|
||||
the master-branch onto them.
|
||||
</p>
|
||||
</section>
|
||||
<section><title>Pushing Git commits to Subversion</title>
|
||||
<p>
|
||||
The following command will push all changes on <code>master</code> back to
|
||||
Subversion:
|
||||
</p>
|
||||
<source>
|
||||
git svn dcommit
|
||||
</source>
|
||||
<p>
|
||||
Note that usually all commits on master will be sent to Subversion
|
||||
in one go, so it's similar to a "push" to another Git repository.
|
||||
|
||||
The dcommit may fail if there are newer revisions in Subversion, you
|
||||
will need to run a <code>git svn rebase</code> first in this case.
|
||||
</p>
|
||||
</section>
|
||||
<section><title>General usage guidelines</title>
|
||||
<p>
|
||||
Although you can use the full power of Git, there are a few
|
||||
things that work well and some things that will get you into
|
||||
trouble:
|
||||
</p>
|
||||
<p>
|
||||
You should not develop on master, rather use some branching
|
||||
concept where you do work on sub-branches and only merge/cherry-pick the
|
||||
changes that are ready for being sent upstream.
|
||||
It seems to work better to constantly rebase changes onto the
|
||||
master branch as this will keep the history clean compared to
|
||||
the SVN repository and will avoid sending useless "Merge" commits to
|
||||
Subversion.
|
||||
</p>
|
||||
<p>
|
||||
You can keep some changes that are only useful locally by using
|
||||
two branches that are rebased onto each other. E.g.
|
||||
something like the following has proven to work well:
|
||||
</p>
|
||||
<source>
|
||||
master
|
||||
-> localchanges - commits that should not be sent upstream ->
|
||||
-> workbranch - place for doing development work
|
||||
</source>
|
||||
<p>
|
||||
When things are ready in the workbranch do a
|
||||
</p>
|
||||
<source>
|
||||
git checkout master
|
||||
git cherry-pick commitid ...
|
||||
</source>
|
||||
<p>
|
||||
to get all the finished commits onto master as preparation for pushing them upstream.
|
||||
|
||||
Then you can <code>git svn dcommit</code> to send the changes upstream
|
||||
and a <code>git svn rebase</code> to get master updated with the newly
|
||||
created SVN revisions.
|
||||
|
||||
Finally do the following to update both branches onto the new SVN head
|
||||
</p>
|
||||
<source>
|
||||
# rebase you local changes onto the latest SVN state
|
||||
git checkout localchanges
|
||||
git rebase master
|
||||
|
||||
# also set the working branch to the latest state from SVN.
|
||||
git checkout workbranch
|
||||
git rebase workbranch
|
||||
</source>
|
||||
<p>
|
||||
Sounds like too much work? Put these steps into a small script and all
|
||||
this will become a simple <code>poiupdate</code> to get all branches
|
||||
rebased onto HEAD from Subversion.
|
||||
</p>
|
||||
</section>
|
||||
</section>
|
||||
<section><title>Code metrics </title>
|
||||
<section><title>Code metrics</title>
|
||||
<p>
|
||||
Code quality reports for Apache POI are available on the
|
||||
<a href="https://sonarcloud.io/dashboard?id=poi-parent">Apache Sonar instance</a>.
|
||||
|
||||
@ -259,7 +259,7 @@
|
||||
depend on supporting services and although the code is adopted, the integration is not well tested ... please support us on
|
||||
integration (testing) with timestamp and revocation (OCSP) services.
|
||||
</p>
|
||||
<p>Further test examples can be found in the corresponding <a href="https://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/test/java/org/apache/poi/poifs/crypt/dsig/TestSignatureInfo.java?view=markup">test class</a>.</p>
|
||||
<p>Further test examples can be found in the corresponding <a href="https://github.com/apache/poi/tree/trunk/poi-ooxml/src/test/java/org/apache/poi/poifs/crypt/dsig/TestSignatureInfo.java?view=markup">test class</a>.</p>
|
||||
|
||||
<p>If you want to use a hash algorithm with 64 bytes (currently only applies to SHA512),
|
||||
<a href="https://bz.apache.org/bugzilla/show_bug.cgi?id=42061">a base64 "feature"</a> in xmlsec
|
||||
@ -366,7 +366,7 @@
|
||||
to extract an OOXML spreadsheet zipped container and write the contents to disk using AES
|
||||
encryption.</p>
|
||||
|
||||
<p>See <a href="https://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/poifs/crypt/temp/SXSSFWorkbookWithCustomZipEntrySource.java?view=markup">SXSSFWorkbookWithCustomZipEntrySource.java</a>
|
||||
<p>See <a href="https://github.com/apache/poi/tree/trunk/poi-ooxml/src/main/java/org/apache/poi/poifs/crypt/temp/SXSSFWorkbookWithCustomZipEntrySource.java?view=markup">SXSSFWorkbookWithCustomZipEntrySource.java</a>
|
||||
and other <a href="https://svn.apache.org/viewvc?view=revision&revision=1768744">files</a>
|
||||
that are needed for this example.</p>
|
||||
</section>
|
||||
|
||||
@ -382,8 +382,8 @@ case HSSFCell.CELL_TYPE_NUMERIC:
|
||||
<p>Apache POI ships with a few programs and a few example programs,
|
||||
which can be used to do some basic performance checks. For testing
|
||||
file generation, the class to use is in the examples package,
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/SSPerformanceTest.java">SSPerformanceTest</a>
|
||||
(<a href="https://svn.apache.org/viewvc/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/SSPerformanceTest.java">viewvc</a>).
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/SSPerformanceTest.java">SSPerformanceTest</a>
|
||||
(<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/SSPerformanceTest.java">viewvc</a>).
|
||||
Run SSPerformanceTest with arguments of the writing type (HSSF, XSSF
|
||||
or SXSSF), the number rows, the number of columns, and if the file
|
||||
should be saved. If you can't run that with 50,000 rows and 50 columns
|
||||
@ -391,11 +391,11 @@ case HSSFCell.CELL_TYPE_NUMERIC:
|
||||
(and ideally all 3 in less than that!), then the problem is with
|
||||
your environment.</p>
|
||||
<p>Next, use the example program
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ToCSV.java">ToCSV</a>
|
||||
(<a href="https://svn.apache.org/viewvc/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ToCSV.java">viewvc</a>)
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ToCSV.java">ToCSV</a>
|
||||
(<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/ss/ToCSV.java">viewvc</a>)
|
||||
to try reading the file in with HSSF or XSSF. Related is
|
||||
<a href="https://svn.apache.org/repos/asf/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">XLSX2CSV</a>
|
||||
(<a href="https://svn.apache.org/viewvc/poi/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">viewvc</a>),
|
||||
<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">XLSX2CSV</a>
|
||||
(<a href="https://github.com/apache/poi/tree/trunk/poi-examples/src/main/java/org/apache/poi/examples/xssf/eventusermodel/XLSX2CSV.java">viewvc</a>),
|
||||
which uses SAX parsing for .xlsx. Run this against both your problem file,
|
||||
and a simple one generated by SSPerformanceTest of the same size. If this is
|
||||
slow, then there could be an Apache POI problem with how the file is being
|
||||
@ -424,7 +424,7 @@ case HSSFCell.CELL_TYPE_NUMERIC:
|
||||
the common parts. Use the sources off <em>poi-ooxml-full</em> for the lite version,
|
||||
which is available from Maven Central - ask your favourite Maven
|
||||
mirror for the <em>poi-ooxml-full-*-sources</em> jar. Alternately, if you download
|
||||
the POI source distribution (or checkout from SVN) and build, Ant will
|
||||
the POI source distribution (or checkout from Git) and build, Ant will
|
||||
automatically compile it for you to generate the source and binary poi-ooxml-full jars.</p>
|
||||
</answer>
|
||||
</faq>
|
||||
|
||||
@ -22,11 +22,11 @@
|
||||
|
||||
The Apache POI web site is https://poi.apache.org/
|
||||
|
||||
The HTML and other files for the web site are stored in svn at https://svn.apache.org/repos/asf/poi/site
|
||||
The HTML and other files for the web site are stored in git at https://github.com/apache/poi/tree/asf-site
|
||||
Committing files to the `publish` directory of this repo will automatically lead to the web site being updated.
|
||||
There may be a small delay and you might need to force a refresh in your browser.
|
||||
|
||||
The site is built from using the main POI svn at https://svn.apache.org/repos/asf/poi/trunk
|
||||
The site is built from using the main POI git at https://github.com/apache/poi/tree/trunk
|
||||
|
||||
Prerequisites
|
||||
-------------
|
||||
@ -47,15 +47,15 @@ Building and Deploying the Site
|
||||
It is recommended that you open a command prompt and set up Java 8 as your default. The web site build will fail
|
||||
if you use a very recent Java version.
|
||||
|
||||
In your local copy of the POI svn (https://svn.apache.org/repos/asf/poi/trunk), run:
|
||||
In your local copy of the POI svn (https://github.com/apache/poi/tree/trunk), run:
|
||||
|
||||
ant site
|
||||
|
||||
After this completes, you can copy the files in `build/site` to the `publish` directory in your poi-site checkout
|
||||
(https://svn.apache.org/repos/asf/poi/site).
|
||||
(https://github.com/apache/poi/tree/asf-site).
|
||||
|
||||
A command like this might work.
|
||||
|
||||
cp -r ~/svn/poi/build/site/* ~/svn/poi-site/publish/
|
||||
cp -r ~/poi/build/site/* ~/poi-site/publish/
|
||||
|
||||
I would recommend that you use `svn stat` and `svn diff` before committing the changes to poi-site.
|
||||
I would recommend that you use `git status` and `git diff` before committing the changes to poi-site.
|
||||
|
||||
@ -95,7 +95,7 @@ svn update --set-depth infinity dist/release/poi/
|
||||
|
||||
|
||||
(II) Making release artifacts
|
||||
Run these commands from a clean checkout of https://svn.apache.org/repos/asf/poi/trunk
|
||||
Run these commands from a clean checkout of https://github.com/apache/poi/tree/trunk
|
||||
|
||||
1. Update the version number in these files and commit the changes to svn.
|
||||
- build.xml (version.id)
|
||||
@ -357,7 +357,7 @@ Note, announcements should be sent from your @apache.org e-mail address.
|
||||
10. In Bugzilla, add a new version and the next "...-dev" version. Also close the n-2 -dev version to new bugs.
|
||||
|
||||
11. Add the version to the DOAP file too
|
||||
https://svn.apache.org/repos/asf/poi/trunk/doap_POI.rdf
|
||||
https://github.com/apache/poi/tree/trunk/doap_POI.rdf
|
||||
|
||||
12. Delete directory that held RC.
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user