Modified: any23/site/release-howto.html URL: http://svn.apache.org/viewvc/any23/site/release-howto.html?rev=1896849&r1=1896848&r2=1896849&view=diff ============================================================================== --- any23/site/release-howto.html (original) +++ any23/site/release-howto.html Sat Jan 8 22:47:23 2022 @@ -1,333 +1,132 @@ <!DOCTYPE html> <!-- - | Generated by Apache Maven Doxia at 2021-09-10 - | Rendered using Apache Maven Fluido Skin 1.3.0 + | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/xdoc/release-howto.xml at 2022-01-08 + | Rendered using Apache Maven Fluido Skin 1.10.0 --> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> <head> <meta charset="UTF-8" /> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="viewport" content="width=device-width, initial-scale=1" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" /> <meta name="author" content="Apache Any23 Team" /> - <meta name="Date-Revision-yyyymmdd" content="20210910" /> - <meta http-equiv="Content-Language" content="en" /> <title>Apache Any23 – Apache Any23 - Release HowTo</title> - <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="./css/apache-maven-fluido-1.10.0.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> + <script src="./js/apache-maven-fluido-1.10.0.min.js"></script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <header> + <div id="banner"> + <div class="pull-left"><a href="index.html" id="bannerLeft"><img src="images/logo-any23.png" alt="Apache Any23: Anything to Triples"/></a></div> + <div class="pull-right"><a href="http://www.apache.org/"; id="bannerRight"><img src="http://www.apache.org/images/feather-small.gif"; alt="Apache Any23"/></a></div> + <div class="clear"><hr/></div> + </div> - - <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script> - - - </head> - <body class="topBarDisabled"> - - - - <div class="container-fluid"> - <div id="banner"> - <div class="pull-left"> - <a href="index.html" id="bannerLeft"> - <img src="images/logo-any23.png" alt="Apache Any23: Anything to Triples"/> - </a> - </div> - <div class="pull-right"> <a href="http://www.apache.org/"; id="bannerRight"> - <img src="http://www.apache.org/images/feather-small.gif"; alt="Apache Any23"/> - </a> - </div> - <div class="clear"><hr/></div> - </div> - - <div id="breadcrumbs"> - <ul class="breadcrumb"> - - - <li id="publishDate">Last Published: 2021-09-10</li> - <li class="divider">|</li> <li id="projectVersion">Version: 2.6-SNAPSHOT</li> - - - - - </ul> - </div> - - + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li id="publishDate">Last Published: 2022-01-08<span class="divider">|</span> +</li> + <li id="projectVersion">Version: 2.7-SNAPSHOT</li> + </ul> + </div> + </header> <div class="row-fluid"> - <div id="leftColumn" class="span3"> + <header id="leftColumn" class="span2"> + <nav class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Apache Any23</li> + <li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li> + <li><a href="download.html" title="Downloads"><span class="icon-chevron-right"></span>Downloads</a></li> + <li><a href="install.html" title="Install"><span class="none"></span>Install</a></li> + <li class="nav-header">Documentation</li> + <li><a href="getting-started.html" title="Getting Started"><span class="none"></span>Getting Started</a></li> + <li><a href="supported-formats.html" title="Supported Formats"><span class="none"></span>Supported Formats</a></li> + <li><a href="extractors.html" title="Extractors"><span class="none"></span>Extractors</a></li> + <li><a href="configuration.html" title="Configuration"><span class="none"></span>Configuration</a></li> + <li><a href="service.html" title="REST Service"><span class="none"></span>REST Service</a></li> + <li><a href="any23-plugins.html" title="Any23 Plugins"><span class="none"></span>Any23 Plugins</a></li> + <li><a href="apidocs/index.html" title="APIs Doc"><span class="none"></span>APIs Doc</a></li> + <li><a href="developers.html" title="Developers Guide"><span class="icon-chevron-down"></span>Developers Guide</a> + <ul class="nav nav-list"> + <li><a href="build-src.html" title="Build from sources"><span class="none"></span>Build from sources</a></li> + <li><a href="dev-data-extraction.html" title="Data Extraction"><span class="none"></span>Data Extraction</a></li> + <li><a href="dev-data-conversion.html" title="Data Conversion"><span class="none"></span>Data Conversion</a></li> + <li><a href="dev-validation-fix.html" title="Validation and Fixing"><span class="none"></span>Validation and Fixing</a></li> + <li><a href="dev-xpath-extractor.html" title="XPath Extractor"><span class="none"></span>XPath Extractor</a></li> + <li><a href="dev-microformat-extractors.html" title="Microformat Extractors"><span class="none"></span>Microformat Extractors</a></li> + <li><a href="dev-microdata-extractor.html" title="Microdata Extractor"><span class="none"></span>Microdata Extractor</a></li> + <li><a href="dev-csv-extractor.html" title="CSV Extractor"><span class="none"></span>CSV Extractor</a></li> + <li class="active"><a href="#"><span class="none"></span>HowTo Release</a></li> + </ul></li> + <li class="nav-header">Project Documentation</li> + <li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> + <li class="nav-header">Misc</li> + <li><a href="acknowledgements.html" title="Acknowledgements"><span class="none"></span>Acknowledgements</a></li> + <li><a href="poweredby.html" title="PoweredBy"><span class="none"></span>PoweredBy</a></li> + <li class="nav-header">ASF</li> + <li><a href="http://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="http://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> + </ul> + </nav> <div class="well sidebar-nav"> - - - <ul class="nav nav-list"> - <li class="nav-header">Apache Any23</li> - - <li> - - <a href="index.html" title="Introduction"> - <i class="none"></i> - Introduction</a> - </li> - - <li> - - <a href="download.html" title="Downloads"> - <i class="icon-chevron-right"></i> - Downloads</a> - </li> - - <li> - - <a href="install.html" title="Install"> - <i class="none"></i> - Install</a> - </li> - <li class="nav-header">Documentation</li> - - <li> - - <a href="getting-started.html" title="Getting Started"> - <i class="none"></i> - Getting Started</a> - </li> - - <li> - - <a href="supported-formats.html" title="Supported Formats"> - <i class="none"></i> - Supported Formats</a> - </li> - - <li> - - <a href="extractors.html" title="Extractors"> - <i class="none"></i> - Extractors</a> - </li> - - <li> - - <a href="configuration.html" title="Configuration"> - <i class="none"></i> - Configuration</a> - </li> - - <li> - - <a href="service.html" title="REST Service"> - <i class="none"></i> - REST Service</a> - </li> - - <li> - - <a href="any23-plugins.html" title="Any23 Plugins"> - <i class="none"></i> - Any23 Plugins</a> - </li> - - <li> - - <a href="apidocs/index.html" title="APIs Doc"> - <i class="none"></i> - APIs Doc</a> - </li> - - <li> - - <a href="developers.html" title="Developers Guide"> - <i class="icon-chevron-down"></i> - Developers Guide</a> - <ul class="nav nav-list"> - - <li> - - <a href="build-src.html" title="Build from sources"> - <i class="none"></i> - Build from sources</a> - </li> - - <li> - - <a href="dev-data-extraction.html" title="Data Extraction"> - <i class="none"></i> - Data Extraction</a> - </li> - - <li> - - <a href="dev-data-conversion.html" title="Data Conversion"> - <i class="none"></i> - Data Conversion</a> - </li> - - <li> - - <a href="dev-validation-fix.html" title="Validation and Fixing"> - <i class="none"></i> - Validation and Fixing</a> - </li> - - <li> - - <a href="dev-xpath-extractor.html" title="XPath Extractor"> - <i class="none"></i> - XPath Extractor</a> - </li> - - <li> - - <a href="dev-microformat-extractors.html" title="Microformat Extractors"> - <i class="none"></i> - Microformat Extractors</a> - </li> - - <li> - - <a href="dev-microdata-extractor.html" title="Microdata Extractor"> - <i class="none"></i> - Microdata Extractor</a> - </li> - - <li> - - <a href="dev-csv-extractor.html" title="CSV Extractor"> - <i class="none"></i> - CSV Extractor</a> - </li> - - <li class="active"> - - <a href="#"><i class="none"></i>HowTo Release</a> - </li> - </ul> - </li> - <li class="nav-header">Project Documentation</li> - - <li> - - <a href="project-info.html" title="Project Information"> - <i class="icon-chevron-right"></i> - Project Information</a> - </li> - - <li> - - <a href="project-reports.html" title="Project Reports"> - <i class="icon-chevron-right"></i> - Project Reports</a> - </li> - <li class="nav-header">Misc</li> - - <li> - - <a href="acknowledgements.html" title="Acknowledgements"> - <i class="none"></i> - Acknowledgements</a> - </li> - - <li> - - <a href="poweredby.html" title="PoweredBy"> - <i class="none"></i> - PoweredBy</a> - </li> - <li class="nav-header">ASF</li> - - <li> - - <a href="http://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"> - <i class="none"></i> - How Apache Works</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/"; class="externalLink" title="Foundation"> - <i class="none"></i> - Foundation</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"> - <i class="none"></i> - Sponsoring Apache</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"> - <i class="none"></i> - Thanks</a> - </li> - </ul> - - - - <hr class="divider" /> - - <div id="poweredBy"> - <div class="clear"></div> - <div class="clear"></div> - <div class="clear"></div> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> - </a> - </div> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a> + </div> </div> - </div> - - - <div id="bodyColumn" class="span9" > - - + </header> + <main id="bodyColumn" class="span10" > + - <div class="section"> + <section> <h2><a name="HowTo_Release_Apache_Any23"></a>HowTo Release Apache Any23</h2> <p>This short guide is for volunteers that intend to cover the role of Release Manager</p> - </div> + </section> - -<div class="section"> + <section> <h2><a name="Prerequisites"></a>Prerequisites</h2> <ul> -<li>Install/Configure <tt>GPG</tt> - The artifacts that are deployed to the ASF central repository need to +<li>Install/Configure <code>GPG</code> - The artifacts that are deployed to the ASF central repository need to be signed. To do this you will need to have a public and private keypair. There is a very good <a class="externalLink" href="http://www.sonatype.com/people/2010/01/how-to-generate-pgp-signatures-with-maven/";>guide</a> that will walk you though this.</li> -<li>Install Apache Maven 2.2.1 or higher. 2.2.0 has a bug that will produce invalid checksums; we strongly - encourage our committers to install Apache Maven 3.0.4.</li> +<li>Install the latest version of <a class="externalLink" href="https://maven.apache.org/download.cgi";>Apache Maven</a>.</li> </ul> - </div> + </section> - -<div class="section"> + <section> <h2><a name="Configuration"></a>Configuration</h2> - -<div class="section"> + <section> <h3><a name="Apache_Maven"></a>Apache Maven</h3> -<p>As of Maven 2.1.0 you can now encrypt your servers passwords. We highly recommend that you follow this +<p>We highly recommend that you follow this <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-encryption.html";>guide</a> to set your master password and use it to encrypt your ASF password in the next section.</p> - </div> + </section> - -<div class="section"> + <section> <h3><a name="ASF_settings"></a>ASF settings</h3> <p>Using the instructions from the previous step encrypt your Sonatype password and add the following servers to - your <tt>~/.m2/settings.xml</tt> file. You may already have other servers in this file. If not just create + your <code>~/.m2/settings.xml</code> file. You may already have other servers in this file. If not just create the file.</p> -<div class="source"> -<pre><?xml version="1.0" encoding="UTF-8"?> +<div class="source"><pre class="prettyprint"><?xml version="1.0" encoding="UTF-8"?> <settings> ... <servers> @@ -361,16 +160,14 @@ </settings></pre></div> -<p>You can find a <a class="externalLink" href="https://svn.apache.org/repos/asf/any23/committers/maven/settings.xml";><tt>settings.xml</tt></a> - template in our SVN committers space</p> - </div> - </div> +<p>You can find a <a class="externalLink" href="https://raw.githubusercontent.com/apache/any23-committers/master/maven/settings.xml";><code>settings.xml</code></a> + template in our Github committers space</p> + </section> + </section> - -<div class="section"> + <section> <h2><a name="Release_steps"></a>Release steps</h2> - -<div class="section"> + <section> <h3><a name="Prepare_the_source_for_release"></a>Prepare the source for release</h3> <ol style="list-style-type: decimal"> @@ -383,9 +180,11 @@ <ol style="list-style-type: decimal"> -<li>Update the <tt>CHANGES</tt> based on the Text release reports from JIRA.</li> +<li>Update the <code>RELEASE-NOTES.md</code> based on the text release reports from JIRA.</li> -<li>Review and update <tt>README</tt> if needed.</li> +<li>Review and update <code>README.md</code> if needed.</li> + +<li>Review and update dates in <code>NOTICE.txt</code> if needed.</li> <li>Commit any changes back to Git: <div> @@ -397,10 +196,9 @@ <div> <pre>mvn clean deploy</pre></div></li> </ol> - </div> + </section> - -<div class="section"> + <section> <h3><a name="Get_source_tree"></a>Get source tree</h3> <ol style="list-style-type: decimal"> @@ -423,15 +221,14 @@ <div> <pre>git clone https://git-wip-us.apache.org/repos/asf/any23.git</pre></div></li> </ol> - </div> + </section> - -<div class="section"> + <section> <h3><a name="Prepare_the_release"></a>Prepare the release</h3> <ol style="list-style-type: decimal"> -<li>Do a dry run of the <tt>release:prepare</tt> step. +<li>Do a dry run of the <code>release:prepare</code> step. <div> <pre>mvn release:prepare -DdryRun=true</pre></div> @@ -440,17 +237,17 @@ release process will complete as expected. -<p><i>If you cancel a <tt>release:prepare</tt> before it updates the pom.xml versions, then use the - <tt>release:clean</tt> goal to just remove the extra files that were created.</i></p></li> +<p><i>If you cancel a <code>release:prepare</code> before it updates the pom.xml versions, then use the + <code>release:clean</code> goal to just remove the extra files that were created.</i></p></li> <li>Verify that the release process completed as expected: <ol style="list-style-type: decimal"> -<li>The release plugin will create <tt>pom.xml.tag</tt> files which contain the changes that would - have been committed to SVN. The only differences between <tt>pom.xml.tag</tt> and its corresponding - <tt>pom.xml</tt> file should be the version +<li>The release plugin will create <code>pom.xml.tag</code> files which contain the changes that would + have been committed to SVN. The only differences between <code>pom.xml.tag</code> and its corresponding + <code>pom.xml</code> file should be the version number.</li> @@ -460,27 +257,25 @@ <pre>git add -A && git commit -m "fixing formatting for release"</pre></div></li> -<li>Assuming the <tt>.tag</tt> files look OK you may proceed and do any other validation you feel +<li>Assuming the <code>.tag</code> files look OK you may proceed and do any other validation you feel necessary. The following list may be helpful: <ol style="list-style-type: decimal"> -<li>Check <tt>release.properties</tt> and make sure that the scm properties have the right version. +<li>Check <code>release.properties</code> and make sure that the scm properties have the right version. Sometimes the scm location can be the previous version not the next version.</li> <li>Verify signatures: On Un*x platforms the following command can be executed: -<div class="source"> -<pre>for file in `find . -type f -iname '*.asc'` +<div class="source"><pre class="prettyprint">for file in `find . -type f -iname '*.asc'` do gpg --verify ${file} done</pre></div> You'll need to look at the output to ensure it contains only good signatures: -<div class="source"> -<pre>gpg: Good signature from ... +<div class="source"><pre class="prettyprint">gpg: Good signature from ... gpg: Signature made ...</pre></div> </li> </ol> @@ -489,31 +284,28 @@ gpg: Signature made ...</pre></div> <li>Once any failures or required updates have been committed to git, rollback the release prepare files: -<div class="source"> -<pre>mvn release:rollback</pre></div></li> +<div class="source"><pre class="prettyprint">mvn release:rollback</pre></div></li> </ol> </li> -<li>Run the <tt>release:prepare</tt> step for real this time. You'll be prompted for the same version +<li>Run the <code>release:prepare</code> step for real this time. You'll be prompted for the same version information and optionally your GPG passphrase again. <div> <pre>mvn release:prepare</pre></div> </li> </ol> - </div> + </section> - -<div class="section"> + <section> <h3><a name="Perform_the_release"></a>Perform the release</h3> <ol style="list-style-type: decimal"> <li> - From the directory where you have launched <tt>release:prepare</tt> execute (this step will create a maven staging repository): + From the directory where you have launched <code>release:prepare</code> execute (this step will create a maven staging repository): -<div class="source"> -<pre>mvn release:perform [-Duser.name=<your_apache_uid>]</pre></div> +<div class="source"><pre class="prettyprint">mvn release:perform [-Duser.name=<your_apache_uid>]</pre></div> <p> @@ -537,15 +329,15 @@ gpg: Signature made ...</pre></div> <li><b>Staging tab --> Name column --> org.apache.any23</b></li> <li>Navigate through the artifact tree and make sure that all binary, - <tt>javadoc</tt>, - <tt>sources</tt>, and - <tt>tests</tt> jars, as well as - <tt>pom</tt>s, ... have - <tt>.asc</tt> (GPG signature) and checksum files (see + <code>javadoc</code>, + <code>sources</code>, and + <code>tests</code> jars, as well as + <code>pom</code>s, ... have + <code>.asc</code> (GPG signature) and checksum files (see <a class="externalLink" href="http://people.apache.org/~henkp/repo/faq.html";>Repository FAQ</a> and <a class="externalLink" href="http://www.apache.org/dev/release-signing.html#openpgp-ascii-detach-sig";>Detached Signatures</a>). - The <tt>any23-sources-dist-X.Y.tar.gz</tt> and - <tt>any23-sources-dist-X.Y.zip</tt> files shall likewise have signature and checksum files. + The <code>any23-sources-dist-X.Y.tar.gz</code> and + <code>any23-sources-dist-X.Y.zip</code> files shall likewise have signature and checksum files. </li> </ol> </li> @@ -561,7 +353,7 @@ gpg: Signature made ...</pre></div> <li><b>Staging tab --> Name column --> org.apache.any23</b></li> -<li>Right click on the open <tt>org.apache.any23-XXX</tt> staging repo and select +<li>Right click on the open <code>org.apache.any23-XXX</code> staging repo and select <b>Close</b>.</li> </ol> </li> @@ -573,15 +365,14 @@ gpg: Signature made ...</pre></div> </li> </ol> - </div> + </section> - -<div class="section"> + <section> <h3><a name="Vote_the_Release"></a>Vote the Release</h3> <ol style="list-style-type: decimal"> -<li>Create a <tt>VOTE</tt> email thread on <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> and <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> +<li>Create a <code>VOTE</code> email thread on <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> and <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> to record votes as replies, e.g.: <div> @@ -592,6 +383,8 @@ Hi, Please VOTE on the release candidate for Apache Any23 ${latestStableRelease} +Note, this release candidate requires JDK11 to build and run. + We solved N issues: http://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12312323&styleName=Html&version=X.Y @@ -601,7 +394,7 @@ https://gitbox.apache.org/repos/asf/any2 Staging repo: https://repository.apache.org/content/repositories/orgapacheany23-[YOUR REPOSITORY ID]/ -Staging binaries: +Sources and CLI binaries area: https://dist.apache.org/repos/dist/dev/any23/${latestStableRelease} PGP release keys (signed using ABCDEFG): @@ -609,7 +402,7 @@ https://dist.apache.org/repos/dist/relea Vote will be open for 72 hours. -[ ] +1, let's get it ruuuumbleeeeee!!! +[ ] +1, Release as Apache Any23 ${latestStableRelease} [ ] +/-0, fine, but consider to fix few issues before... [ ] -1, nope, because... (and please explain why)</pre></div> </li> @@ -619,18 +412,17 @@ Vote will be open for 72 hours. <a class="externalLink" href="http://www.apache.org/legal/release-policy.html";>http://www.apache.org/legal/release-policy.html</a>.</li> -<li>A <tt>-1</tt> vote does not necessarily mean that the vote must be redone, however it is usually a - good idea to rollback the release if a <tt>-1</tt> vote is received +<li>A <code>-1</code> vote does not necessarily mean that the vote must be redone, however it is usually a + good idea to rollback the release if a <code>-1</code> vote is received (see "Recovering from a vetoed release" below).</li> <li>After the vote has been open for at least 72 hours, has at least three +1 PMC votes and no -1 votes, then - post the results to the vote thread, replying to the initial email prepending <tt>[RESULT]</tt> to the - original subject and include a list of every binding <tt>+1</tt>, <tt>0</tt> and <tt>-1</tt> vote. + post the results to the vote thread, replying to the initial email prepending <code>[RESULT]</code> to the + original subject and include a list of every binding <code>+1</code>, <code>0</code> and <code>-1</code> vote. <div> -<pre>To: "Apache Any23 Developers List" <[email protected]> -CC: "Apache Any23 PMC List" <[email protected]> +<pre>To: "Apache Any23 Developers List" <[email protected]>, "Apache Any23 Users List" <[email protected]> Subject: [RESULT] [VOTE] Release Apache Any23 X.Y Hi, @@ -651,10 +443,9 @@ The vote has passed with the following r I will promote the artifacts to the central repo.</pre></div> </li> </ol> - </div> + </section> - -<div class="section"> + <section> <h3><a name="Finalize_the_Release"></a>Finalize the Release</h3> <ol style="list-style-type: decimal"> @@ -669,7 +460,7 @@ I will promote the artifacts to the cent <li><b>Staging tab --> Name column --> org.apache.any23</b></li> -<li>Right click on the closed <tt>org.apache.any23-XXX</tt> staging repo and select <b>Release</b>. +<li>Right click on the closed <code>org.apache.any23-XXX</code> staging repo and select <b>Release</b>. </li> </ol> </li> @@ -682,18 +473,22 @@ I will promote the artifacts to the cent <a class="externalLink" href="https://issues.apache.org/jira/plugins/servlet/project-config/ANY23/versions";>JIRA versions</a> page to mark the version as <b>Released</b>, and set the date to the date that the release was approved. You may also need to make a new release entry for the next release.</li> + +<li><a class="externalLink" href="https://cwiki.apache.org/confluence/display/ANY23/Building+Apache+Any23+Website+HOW_TO";>Update the Any23 website</a></li> </ol> - </div> + </section> - -<div class="section"> + <section> <h3><a name="Announce_the_Release"></a>Announce the Release</h3> <p>Make an announcement about the release on the <a class="externalLink" href="mailto:[email protected]";>any23-user</a>, <a class="externalLink" href="mailto:[email protected]";>any23-dev</a>, <a class="externalLink" href="https://groups.google.com/d/forum/web-data-commons";>Web Data Commons - Google Group</a>, - maybe some other relevant W3C and/or OGC groups, and + <a class="externalLink" href="mailto:[email protected]";>nutch-dev</a>, + <a class="externalLink" href="mailto:[email protected]";>camel-dev</a>, + <a class="externalLink" href="mailto:[email protected]";>servicemix-dev</a>, + maybe some other relevant W3C and/or OGC groups as you see fit, and <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> lists as per <a class="externalLink" href="http://www.apache.org/foundation/mailinglists.html#foundation-announce";>the Apache Announcement Mailing Lists page</a> </p> @@ -707,10 +502,11 @@ Subject: [ANNOUNCE] Apache Any23 X.Y The Apache Any23 Team is pleased to announce the release of Apache Any23 ${latestStableRelease}. -Apache Anything To Triples (Any23) is a library, a web service and a command line tool that -extracts structured data in RDF format from a variety of Web documents. +Apache Anything To Triples (Any23) is a library, a web service and a command line tool that extracts structured data in RDF format from a variety of Web documents. + +Any23 ${latestStableRelease} requires JDK11 to build and run. -Release Notes: https://github.com/apache/any23/blob/any23-${latestStableRelease}/RELEASE-NOTES.txt +Release Notes: https://github.com/apache/any23/blob/any23-${latestStableRelease}/RELEASE-NOTES.md Download: http://any23.apache.org/download.html @@ -721,30 +517,28 @@ DOAP: https://github.com/apache/any23-co Have Fun, (Lewis), on behalf of the Apache Any23 PMC N.B. The release artifacts can take a bit of time to reach the distribution servers, please be patient.</pre></div> - </div> - </div> + </section> + </section> - -<div class="section"> + <section> <h2><a name="Recovering_from_a_vetoed_release"></a>Recovering from a vetoed release</h2> <ol style="list-style-type: decimal"> -<li>Reply to the initial vote email prepending <tt>[CANCELED]</tt> to the original subject.</li> +<li>Reply to the initial vote email prepending <code>[CANCELED]</code> to the original subject.</li> <li>Rollback the version upgrades in trunk by <i>either</i>: <ol style="list-style-type: decimal"> <li>Restore the 0.1-rc1.tar.gz and run -<div class="source"> -<pre>mvn release:rollback</pre></div> <i>or</i> +<div class="source"><pre class="prettyprint">mvn release:rollback</pre></div> <i>or</i> manually revert the versions in trunk to the prior version and commit</li> </ol> </li> -<li>Delete the git tag created by the <tt>release:perform</tt> step (N.B. replace ${tag_name} with the actual tag name): +<li>Delete the git tag created by the <code>release:perform</code> step (N.B. replace ${tag_name} with the actual tag name): <div> <pre>git tag -d ${tag_name} && git push origin :refs/tags/${tag_name}</pre></div></li> @@ -760,7 +554,7 @@ N.B. The release artifacts can take a bi <li><b>Staging tab --> Name column --> org.apache.any23</b></li> -<li>Right click on the closed <tt>org.apache.any23-XXX</tt> staging repo and select <b>Drop</b>. +<li>Right click on the closed <code>org.apache.any23-XXX</code> staging repo and select <b>Drop</b>. </li> </ol> </li> @@ -771,27 +565,26 @@ N.B. The release artifacts can take a bi <li>Spin another release attempt!</li> </ol> - </div> + </section> - </div> - </div> - </div> - + </main> + </div> + </div> <hr/> - <footer> - <div class="container-fluid"> - <div class="row span12">Copyright © 2010-2021 - <a href="https://www.apache.org/";>The Apache Software Foundation</a>. - All Rights Reserved. - + <div class="container-fluid"> + <div class="row-fluid"> +<div class="row span16">Apache Any23, Apache, the Apache feather logo, and the Apache Any23 project logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. + </div> + </div> </div> - - - - </div> </footer> +<script> + if(anchors) { + anchors.add(); + } +</script> </body> </html>
Modified: any23/site/scm.html URL: http://svn.apache.org/viewvc/any23/site/scm.html?rev=1896849&r1=1896848&r2=1896849&view=diff ============================================================================== --- any23/site/scm.html (original) +++ any23/site/scm.html Sat Jan 8 22:47:23 2022 @@ -1,363 +1,124 @@ <!DOCTYPE html> <!-- - | Generated by Apache Maven Doxia at 2021-09-10 - | Rendered using Apache Maven Fluido Skin 1.3.0 + | Generated by Apache Maven Doxia Site Renderer 1.9.2 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.1.2:scm at 2022-01-08 + | Rendered using Apache Maven Fluido Skin 1.10.0 --> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> <head> <meta charset="UTF-8" /> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="Date-Revision-yyyymmdd" content="20210910" /> - <meta http-equiv="Content-Language" content="en" /> + <meta name="viewport" content="width=device-width, initial-scale=1" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" /> <title>Apache Any23 – Source Code Management</title> - <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="./css/apache-maven-fluido-1.10.0.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> + <script src="./js/apache-maven-fluido-1.10.0.min.js"></script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <header> + <div id="banner"> + <div class="pull-left"><a href="index.html" id="bannerLeft"><img src="images/logo-any23.png" alt="Apache Any23: Anything to Triples"/></a></div> + <div class="pull-right"><a href="http://www.apache.org/"; id="bannerRight"><img src="http://www.apache.org/images/feather-small.gif"; alt="Apache Any23"/></a></div> + <div class="clear"><hr/></div> + </div> - - <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script> - - - </head> - <body class="topBarDisabled"> - - - - <div class="container-fluid"> - <div id="banner"> - <div class="pull-left"> - <a href="index.html" id="bannerLeft"> - <img src="images/logo-any23.png" alt="Apache Any23: Anything to Triples"/> - </a> - </div> - <div class="pull-right"> <a href="http://www.apache.org/"; id="bannerRight"> - <img src="http://www.apache.org/images/feather-small.gif"; alt="Apache Any23"/> - </a> - </div> - <div class="clear"><hr/></div> - </div> - - <div id="breadcrumbs"> - <ul class="breadcrumb"> - - - <li id="publishDate">Last Published: 2021-09-10</li> - <li class="divider">|</li> <li id="projectVersion">Version: 2.6-SNAPSHOT</li> - - - - - </ul> - </div> - - + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li id="publishDate">Last Published: 2022-01-08<span class="divider">|</span> +</li> + <li id="projectVersion">Version: 2.7-SNAPSHOT</li> + </ul> + </div> + </header> <div class="row-fluid"> - <div id="leftColumn" class="span3"> + <header id="leftColumn" class="span2"> + <nav class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Apache Any23</li> + <li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li> + <li><a href="download.html" title="Downloads"><span class="icon-chevron-right"></span>Downloads</a></li> + <li><a href="install.html" title="Install"><span class="none"></span>Install</a></li> + <li class="nav-header">Documentation</li> + <li><a href="getting-started.html" title="Getting Started"><span class="none"></span>Getting Started</a></li> + <li><a href="supported-formats.html" title="Supported Formats"><span class="none"></span>Supported Formats</a></li> + <li><a href="extractors.html" title="Extractors"><span class="none"></span>Extractors</a></li> + <li><a href="configuration.html" title="Configuration"><span class="none"></span>Configuration</a></li> + <li><a href="service.html" title="REST Service"><span class="none"></span>REST Service</a></li> + <li><a href="any23-plugins.html" title="Any23 Plugins"><span class="none"></span>Any23 Plugins</a></li> + <li><a href="apidocs/index.html" title="APIs Doc"><span class="none"></span>APIs Doc</a></li> + <li><a href="developers.html" title="Developers Guide"><span class="icon-chevron-right"></span>Developers Guide</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="project-info.html" title="Project Information"><span class="icon-chevron-down"></span>Project Information</a> + <ul class="nav nav-list"> + <li><a href="ci-management.html" title="CI Management"><span class="none"></span>CI Management</a></li> + <li><a href="dependency-convergence.html" title="Dependency Convergence"><span class="none"></span>Dependency Convergence</a></li> + <li><a href="dependency-info.html" title="Dependency Information"><span class="none"></span>Dependency Information</a></li> + <li><a href="dependency-management.html" title="Dependency Management"><span class="none"></span>Dependency Management</a></li> + <li><a href="distribution-management.html" title="Distribution Management"><span class="none"></span>Distribution Management</a></li> + <li><a href="index.html" title="About"><span class="none"></span>About</a></li> + <li><a href="issue-management.html" title="Issue Management"><span class="none"></span>Issue Management</a></li> + <li><a href="licenses.html" title="Licenses"><span class="none"></span>Licenses</a></li> + <li><a href="mailing-lists.html" title="Mailing Lists"><span class="none"></span>Mailing Lists</a></li> + <li><a href="modules.html" title="Project Modules"><span class="none"></span>Project Modules</a></li> + <li><a href="plugin-management.html" title="Plugin Management"><span class="none"></span>Plugin Management</a></li> + <li><a href="plugins.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li class="active"><a href="#"><span class="none"></span>Source Code Management</a></li> + <li><a href="summary.html" title="Summary"><span class="none"></span>Summary</a></li> + <li><a href="team.html" title="Team"><span class="none"></span>Team</a></li> + </ul></li> + <li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> + <li class="nav-header">Misc</li> + <li><a href="acknowledgements.html" title="Acknowledgements"><span class="none"></span>Acknowledgements</a></li> + <li><a href="poweredby.html" title="PoweredBy"><span class="none"></span>PoweredBy</a></li> + <li class="nav-header">ASF</li> + <li><a href="http://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="http://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> + </ul> + </nav> <div class="well sidebar-nav"> - - - <ul class="nav nav-list"> - <li class="nav-header">Apache Any23</li> - - <li> - - <a href="index.html" title="Introduction"> - <i class="none"></i> - Introduction</a> - </li> - - <li> - - <a href="download.html" title="Downloads"> - <i class="icon-chevron-right"></i> - Downloads</a> - </li> - - <li> - - <a href="install.html" title="Install"> - <i class="none"></i> - Install</a> - </li> - <li class="nav-header">Documentation</li> - - <li> - - <a href="getting-started.html" title="Getting Started"> - <i class="none"></i> - Getting Started</a> - </li> - - <li> - - <a href="supported-formats.html" title="Supported Formats"> - <i class="none"></i> - Supported Formats</a> - </li> - - <li> - - <a href="extractors.html" title="Extractors"> - <i class="none"></i> - Extractors</a> - </li> - - <li> - - <a href="configuration.html" title="Configuration"> - <i class="none"></i> - Configuration</a> - </li> - - <li> - - <a href="service.html" title="REST Service"> - <i class="none"></i> - REST Service</a> - </li> - - <li> - - <a href="any23-plugins.html" title="Any23 Plugins"> - <i class="none"></i> - Any23 Plugins</a> - </li> - - <li> - - <a href="apidocs/index.html" title="APIs Doc"> - <i class="none"></i> - APIs Doc</a> - </li> - - <li> - - <a href="developers.html" title="Developers Guide"> - <i class="icon-chevron-right"></i> - Developers Guide</a> - </li> - <li class="nav-header">Project Documentation</li> - - <li> - - <a href="project-info.html" title="Project Information"> - <i class="icon-chevron-down"></i> - Project Information</a> - <ul class="nav nav-list"> - - <li> - - <a href="ci-management.html" title="CI Management"> - <i class="none"></i> - CI Management</a> - </li> - - <li> - - <a href="dependency-convergence.html" title="Dependency Convergence"> - <i class="none"></i> - Dependency Convergence</a> - </li> - - <li> - - <a href="dependency-info.html" title="Dependency Information"> - <i class="none"></i> - Dependency Information</a> - </li> - - <li> - - <a href="dependency-management.html" title="Dependency Management"> - <i class="none"></i> - Dependency Management</a> - </li> - - <li> - - <a href="distribution-management.html" title="Distribution Management"> - <i class="none"></i> - Distribution Management</a> - </li> - - <li> - - <a href="index.html" title="About"> - <i class="none"></i> - About</a> - </li> - - <li> - - <a href="issue-management.html" title="Issue Management"> - <i class="none"></i> - Issue Management</a> - </li> - - <li> - - <a href="licenses.html" title="Licenses"> - <i class="none"></i> - Licenses</a> - </li> - - <li> - - <a href="mailing-lists.html" title="Mailing Lists"> - <i class="none"></i> - Mailing Lists</a> - </li> - - <li> - - <a href="modules.html" title="Project Modules"> - <i class="none"></i> - Project Modules</a> - </li> - - <li> - - <a href="plugin-management.html" title="Plugin Management"> - <i class="none"></i> - Plugin Management</a> - </li> - - <li> - - <a href="plugins.html" title="Plugins"> - <i class="none"></i> - Plugins</a> - </li> - - <li class="active"> - - <a href="#"><i class="none"></i>Source Code Management</a> - </li> - - <li> - - <a href="summary.html" title="Summary"> - <i class="none"></i> - Summary</a> - </li> - - <li> - - <a href="team.html" title="Team"> - <i class="none"></i> - Team</a> - </li> - </ul> - </li> - - <li> - - <a href="project-reports.html" title="Project Reports"> - <i class="icon-chevron-right"></i> - Project Reports</a> - </li> - <li class="nav-header">Misc</li> - - <li> - - <a href="acknowledgements.html" title="Acknowledgements"> - <i class="none"></i> - Acknowledgements</a> - </li> - - <li> - - <a href="poweredby.html" title="PoweredBy"> - <i class="none"></i> - PoweredBy</a> - </li> - <li class="nav-header">ASF</li> - - <li> - - <a href="http://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"> - <i class="none"></i> - How Apache Works</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/"; class="externalLink" title="Foundation"> - <i class="none"></i> - Foundation</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"> - <i class="none"></i> - Sponsoring Apache</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"> - <i class="none"></i> - Thanks</a> - </li> - </ul> - - - - <hr class="divider" /> - - <div id="poweredBy"> - <div class="clear"></div> - <div class="clear"></div> - <div class="clear"></div> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> - </a> - </div> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a> + </div> </div> - </div> - - - <div id="bodyColumn" class="span9" > - - <div class="section"> + </header> + <main id="bodyColumn" class="span10" > +<section> <h2><a name="Overview"></a>Overview</h2><a name="Overview"></a> -<p>This project uses <a class="externalLink" href="https://git-scm.com/";>Git</a> to manage its source code. Instructions on Git use can be found at <a class="externalLink" href="https://git-scm.com/documentation";>https://git-scm.com/documentation</a>.</p></div> -<div class="section"> +<p>This project uses <a class="externalLink" href="https://git-scm.com/";>Git</a> to manage its source code. Instructions on Git use can be found at <a class="externalLink" href="https://git-scm.com/documentation";>https://git-scm.com/documentation</a>.</p></section><section> <h2><a name="Web_Browser_Access"></a>Web Browser Access</h2><a name="Web_Browser_Access"></a> <p>The following is a link to a browsable version of the source repository:</p> -<div class="source"> -<pre><a class="externalLink" href="https://gitbox.apache.org/repos/asf/any23.git";>https://gitbox.apache.org/repos/asf/any23.git</a></pre></div></div> -<div class="section"> +<div class="source"><pre class="prettyprint"><a class="externalLink" href="https://gitbox.apache.org/repos/asf/any23.git";>https://gitbox.apache.org/repos/asf/any23.git</a></pre></div></section><section> <h2><a name="Anonymous_Access"></a>Anonymous Access</h2><a name="Anonymous_Access"></a> <p>The source can be checked out anonymously from Git with this command (See <a class="externalLink" href="https://git-scm.com/docs/git-clone";>https://git-scm.com/docs/git-clone</a>):</p> -<div class="source"> -<pre>$ git clone http://gitbox.apache.org/repos/asf/any23.git</pre></div></div> -<div class="section"> +<div class="source"><pre class="prettyprint">$ git clone --branch any23-2.6 http://gitbox.apache.org/repos/asf/any23.git</pre></div></section><section> <h2><a name="Developer_Access"></a>Developer Access</h2><a name="Developer_Access"></a> <p>Only project developers can access the Git tree via this method (See <a class="externalLink" href="https://git-scm.com/docs/git-clone";>https://git-scm.com/docs/git-clone</a>).</p> -<div class="source"> -<pre>$ git clone https://gitbox.apache.org/repos/asf/any23.git</pre></div></div> -<div class="section"> +<div class="source"><pre class="prettyprint">$ git clone --branch any23-2.6 https://gitbox.apache.org/repos/asf/any23.git</pre></div></section><section> <h2><a name="Access_from_Behind_a_Firewall"></a>Access from Behind a Firewall</h2><a name="Access_from_Behind_a_Firewall"></a> -<p>Refer to the documentation of the SCM used for more information about access behind a firewall.</p></div> - </div> - </div> - </div> - +<p>Refer to the documentation of the SCM used for more information about access behind a firewall.</p></section> + </main> + </div> + </div> <hr/> - <footer> - <div class="container-fluid"> - <div class="row span12">Copyright © 2010-2021 - <a href="https://www.apache.org/";>The Apache Software Foundation</a>. - All Rights Reserved. - + <div class="container-fluid"> + <div class="row-fluid"> +<div class="row span16">Apache Any23, Apache, the Apache feather logo, and the Apache Any23 project logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. + </div> + </div> </div> - - - - </div> </footer> +<script> + if(anchors) { + anchors.add(); + } +</script> </body> </html> Modified: any23/site/service.html URL: http://svn.apache.org/viewvc/any23/site/service.html?rev=1896849&r1=1896848&r2=1896849&view=diff ============================================================================== --- any23/site/service.html (original) +++ any23/site/service.html Sat Jan 8 22:47:23 2022 @@ -1,231 +1,87 @@ <!DOCTYPE html> <!-- - | Generated by Apache Maven Doxia at 2021-09-10 - | Rendered using Apache Maven Fluido Skin 1.3.0 + | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/apt/service.apt at 2022-01-08 + | Rendered using Apache Maven Fluido Skin 1.10.0 --> -<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> +<html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> <head> <meta charset="UTF-8" /> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="viewport" content="width=device-width, initial-scale=1" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" /> <meta name="author" content="The Apache Software Foundation" /> - <meta name="Date-Revision-yyyymmdd" content="20210910" /> - <meta http-equiv="Content-Language" content="en" /> <title>Apache Any23 – Apache Any23 - REST Service</title> - <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" /> + <link rel="stylesheet" href="./css/apache-maven-fluido-1.10.0.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> + <script src="./js/apache-maven-fluido-1.10.0.min.js"></script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <header> + <div id="banner"> + <div class="pull-left"><a href="index.html" id="bannerLeft"><img src="images/logo-any23.png" alt="Apache Any23: Anything to Triples"/></a></div> + <div class="pull-right"><a href="http://www.apache.org/"; id="bannerRight"><img src="http://www.apache.org/images/feather-small.gif"; alt="Apache Any23"/></a></div> + <div class="clear"><hr/></div> + </div> - - <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script> - - - </head> - <body class="topBarDisabled"> - - - - <div class="container-fluid"> - <div id="banner"> - <div class="pull-left"> - <a href="index.html" id="bannerLeft"> - <img src="images/logo-any23.png" alt="Apache Any23: Anything to Triples"/> - </a> - </div> - <div class="pull-right"> <a href="http://www.apache.org/"; id="bannerRight"> - <img src="http://www.apache.org/images/feather-small.gif"; alt="Apache Any23"/> - </a> - </div> - <div class="clear"><hr/></div> - </div> - - <div id="breadcrumbs"> - <ul class="breadcrumb"> - - - <li id="publishDate">Last Published: 2021-09-10</li> - <li class="divider">|</li> <li id="projectVersion">Version: 2.6-SNAPSHOT</li> - - - - - </ul> - </div> - - + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li id="publishDate">Last Published: 2022-01-08<span class="divider">|</span> +</li> + <li id="projectVersion">Version: 2.7-SNAPSHOT</li> + </ul> + </div> + </header> <div class="row-fluid"> - <div id="leftColumn" class="span3"> + <header id="leftColumn" class="span2"> + <nav class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Apache Any23</li> + <li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li> + <li><a href="download.html" title="Downloads"><span class="icon-chevron-right"></span>Downloads</a></li> + <li><a href="install.html" title="Install"><span class="none"></span>Install</a></li> + <li class="nav-header">Documentation</li> + <li><a href="getting-started.html" title="Getting Started"><span class="none"></span>Getting Started</a></li> + <li><a href="supported-formats.html" title="Supported Formats"><span class="none"></span>Supported Formats</a></li> + <li><a href="extractors.html" title="Extractors"><span class="none"></span>Extractors</a></li> + <li><a href="configuration.html" title="Configuration"><span class="none"></span>Configuration</a></li> + <li class="active"><a href="#"><span class="none"></span>REST Service</a></li> + <li><a href="any23-plugins.html" title="Any23 Plugins"><span class="none"></span>Any23 Plugins</a></li> + <li><a href="apidocs/index.html" title="APIs Doc"><span class="none"></span>APIs Doc</a></li> + <li><a href="developers.html" title="Developers Guide"><span class="icon-chevron-right"></span>Developers Guide</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> + <li class="nav-header">Misc</li> + <li><a href="acknowledgements.html" title="Acknowledgements"><span class="none"></span>Acknowledgements</a></li> + <li><a href="poweredby.html" title="PoweredBy"><span class="none"></span>PoweredBy</a></li> + <li class="nav-header">ASF</li> + <li><a href="http://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="http://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> + </ul> + </nav> <div class="well sidebar-nav"> - - - <ul class="nav nav-list"> - <li class="nav-header">Apache Any23</li> - - <li> - - <a href="index.html" title="Introduction"> - <i class="none"></i> - Introduction</a> - </li> - - <li> - - <a href="download.html" title="Downloads"> - <i class="icon-chevron-right"></i> - Downloads</a> - </li> - - <li> - - <a href="install.html" title="Install"> - <i class="none"></i> - Install</a> - </li> - <li class="nav-header">Documentation</li> - - <li> - - <a href="getting-started.html" title="Getting Started"> - <i class="none"></i> - Getting Started</a> - </li> - - <li> - - <a href="supported-formats.html" title="Supported Formats"> - <i class="none"></i> - Supported Formats</a> - </li> - - <li> - - <a href="extractors.html" title="Extractors"> - <i class="none"></i> - Extractors</a> - </li> - - <li> - - <a href="configuration.html" title="Configuration"> - <i class="none"></i> - Configuration</a> - </li> - - <li class="active"> - - <a href="#"><i class="none"></i>REST Service</a> - </li> - - <li> - - <a href="any23-plugins.html" title="Any23 Plugins"> - <i class="none"></i> - Any23 Plugins</a> - </li> - - <li> - - <a href="apidocs/index.html" title="APIs Doc"> - <i class="none"></i> - APIs Doc</a> - </li> - - <li> - - <a href="developers.html" title="Developers Guide"> - <i class="icon-chevron-right"></i> - Developers Guide</a> - </li> - <li class="nav-header">Project Documentation</li> - - <li> - - <a href="project-info.html" title="Project Information"> - <i class="icon-chevron-right"></i> - Project Information</a> - </li> - - <li> - - <a href="project-reports.html" title="Project Reports"> - <i class="icon-chevron-right"></i> - Project Reports</a> - </li> - <li class="nav-header">Misc</li> - - <li> - - <a href="acknowledgements.html" title="Acknowledgements"> - <i class="none"></i> - Acknowledgements</a> - </li> - - <li> - - <a href="poweredby.html" title="PoweredBy"> - <i class="none"></i> - PoweredBy</a> - </li> - <li class="nav-header">ASF</li> - - <li> - - <a href="http://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"> - <i class="none"></i> - How Apache Works</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/"; class="externalLink" title="Foundation"> - <i class="none"></i> - Foundation</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"> - <i class="none"></i> - Sponsoring Apache</a> - </li> - - <li> - - <a href="http://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"> - <i class="none"></i> - Thanks</a> - </li> - </ul> - - - - <hr class="divider" /> - - <div id="poweredBy"> - <div class="clear"></div> - <div class="clear"></div> - <div class="clear"></div> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> - </a> - </div> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a> + </div> </div> - </div> - - - <div id="bodyColumn" class="span9" > - - <div class="section"> + </header> + <main id="bodyColumn" class="span10" > +<section> <h2><a name="Apache_Any23_REST_Service"></a>Apache Any23 REST Service</h2> -<p><i>Apache Any23</i> provides REST Service module <i>any23-service</i> able to provide useful processing methods.</p> -<div class="section"> +<p><i>Apache Any23</i> provides REST Service module <i>any23-service</i> able to provide useful processing methods.</p><section> <h3><a name="Compact_API"></a>Compact API</h3> <p>HTTP GET requests can be made to IRIs of the shape:</p> -<div class="source"> -<pre>http://<any23-service-host>/<output-format>/<input-uri></pre></div> +<div class="source"><pre class="prettyprint">http://<any23-service-host>/<output-format>/<input-uri></pre></div> <p>Where <i>input-uri</i> is the input HTTP resource to be processed and <i>output-format</i> is the desired output format for the extracted RDF data.</p> <p>Example requests:</p> -<div class="source"> -<pre>http://any23.org/best/twitter.com/cygri +<div class="source"><pre class="prettyprint">http://any23.org/best/twitter.com/cygri http://any23.org/rdfxml/http://data.gov http://any23.org/ttl/http://www.w3.org/People/Berners-Lee/card http://any23.org/?uri=http://dbpedia.org/resource/Berlin @@ -233,14 +89,11 @@ http://any23.org/?format=nt&uri=http <p>Supported input and output formats are described <a href="./supported-formats.html"> here</a>.</p> <p>Form-style GET API</p> <p>HTTP GET requests can be made to the IRI http://any23.org/ with the following query parameters:</p> -<div class="source"> -<pre>uri IRI of an input document -format Desired output format; defaults to best</pre></div></div> -<div class="section"> +<div class="source"><pre class="prettyprint">uri IRI of an input document +format Desired output format; defaults to best</pre></div></section><section> <h3><a name="Direct_POST_API"></a>Direct POST API</h3> <p>HTTP POSTing a document body to http://any23.org/format will convert the document to the specified output format. The media type of the input has to be specified in the Content-Type HTTP header. Depending on the servlet container, a Content-Length header specifying the length of the input document in bytes might also be required. Typical media types for supported input formats are:</p> -<div class="source"> -<pre>Input format Media type +<div class="source"><pre class="prettyprint">Input format Media type ------------------------------- HTML text/html RDF/XML application/rdf+xml @@ -248,8 +101,7 @@ Turtle text/turtle N-Triples text/plain N-Quads text/plain</pre></div> <p>Example POST request:</p> -<div class="source"> -<pre>POST /rdfxml HTTP/1.0 +<div class="source"><pre class="prettyprint">POST /rdfxml HTTP/1.0 Host: any23.org Content-Type: text/turtle Content-Length: 174 @@ -259,8 +111,7 @@ Content-Length: 174 [] a foaf:Person; foaf:name "John X. Foobar"; foaf:mbox_sha1sum "cef817456278b70cee8e5a1611539ef9d928810e"; - .</pre></div></div> -<div class="section"> + .</pre></div></section><section> <h3><a name="Form-style_POST_API"></a>Form-style POST API</h3> <p>A document body can also be converted by HTTP POSTing form data to http://any23.org/. The Content-Type HTTP header must be set to <i>application/x-www-form-urlencoded</i>. The following parameters are supported:</p> <table border="1" class="table table-striped"> @@ -275,15 +126,12 @@ Content-Length: 174 <td align="left">Desired output format; defaults to <b>best</b>.</td></tr> <tr class="b"> <td align="left">validation</td> -<td align="left">The validation level to be applied, supported values: <b>none</b> (default), <b>validate</b> and <b>validate-fix</b>.</td></tr></table></div> -<div class="section"> +<td align="left">The validation level to be applied, supported values: <b>none</b> (default), <b>validate</b> and <b>validate-fix</b>.</td></tr></table></section><section> <h3><a name="Output_Formats"></a>Output Formats</h3> -<p>Supported input and output formats are described <a href="./supported-formats.html"> here</a>.</p></div> -<div class="section"> +<p>Supported input and output formats are described <a href="./supported-formats.html"> here</a>.</p></section><section> <h3><a name="Error_reporting"></a>Error reporting</h3> <p>Processing errors are indicated via HTTP status codes and brief text/plain error messages. The following status codes can be returned:</p> -<div class="source"> -<pre>Code Reason +<div class="source"><pre class="prettyprint">Code Reason ------------------------------------------------------------------------------------------------------------- 200 OK Success. 400 Bad Request Missing or malformed input parameter. @@ -291,18 +139,15 @@ Content-Length: 174 406 Not Acceptable None of the media types specified in the Accept header are supported. 415 Unsupported Media Type Document body with unsupported media type was POSTed. 501 Not Implemented Extraction from input was successful, but yielded zero triples. -502 Bad Gateway Input document from a remote server could not be fetched or parsed.</pre></div></div> -<div class="section"> +502 Bad Gateway Input document from a remote server could not be fetched or parsed.</pre></div></section><section> <h3><a name="XML_Report_Format"></a>XML Report Format</h3> <p><a name="report-format">report-format</a></p> <p>The <i>Apache Any23 Service</i> can optionally return an XML report and attempt error fix if the flags <i>fix</i> and <i>report</i> are activated ( <i>fix=on&report=on</i> ). The following URL shows how to use these flags.</p> -<div class="source"> -<pre>http://any23.org/any23-service/any23/?format=best&uri=http%3A%2F%2Fpath%2Fto%2Fresource&validation=none&report=on</pre></div> +<div class="source"><pre class="prettyprint">http://any23.org/any23-service/any23/?format=best&uri=http%3A%2F%2Fpath%2Fto%2Fresource&validation=none&report=on</pre></div> <p>The <i>fix</i> functionality is described <a href="./dev-validation-fix.html">here</a>.</p> <p>A report format example is listed below. In particular ath path <i>response/extractors/extractor</i> it is possible to find the list of all extractors activated during the page processing. The section <i>response/report/message</i> contains an eventual error message while the <i>response/report/error</i> section the error stack trace if available.</p> <p>The result of validation is contained within the <i>response/report/validationReport</i> node. Within that node there is the list of the activated rules, the issues detected and the errors generated.</p> -<div class="source"> -<pre><?xml version="1.0" encoding="UTF-8" ?> +<div class="source"><pre class="prettyprint"><?xml version="1.0" encoding="UTF-8" ?> <response> <!-- List of activated extractors. --> <extractors> @@ -330,24 +175,23 @@ Content-Length: 174 -- Actual Data in the format specified as output. -- ]]> </data> -</response></pre></div></div></div> - </div> - </div> - </div> - +</response></pre></div></section></section> + </main> + </div> + </div> <hr/> - <footer> - <div class="container-fluid"> - <div class="row span12">Copyright © 2010-2021 - <a href="https://www.apache.org/";>The Apache Software Foundation</a>. - All Rights Reserved. - + <div class="container-fluid"> + <div class="row-fluid"> +<div class="row span16">Apache Any23, Apache, the Apache feather logo, and the Apache Any23 project logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. + </div> + </div> </div> - - - - </div> </footer> +<script> + if(anchors) { + anchors.add(); + } +</script> </body> </html>
![http://www.apache.org/images/feather-small.gif"](http://www.apache.org/images/feather-small.gif"){kind=link}