You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by jt...@apache.org on 2006/05/31 00:12:40 UTC
svn commit: r410391 - in /db/derby/site/trunk:
build/site/papers/derby_web.html
src/documentation/content/xdocs/papers/derby_web.xml
Author: jta
Date: Tue May 30 15:12:40 2006
New Revision: 410391
URL: http://svn.apache.org/viewvc?rev=410391&view=rev
Log:
Adding a plug for using jEdit to edit forrest XML source on the Derby
web site.
Modified:
db/derby/site/trunk/build/site/papers/derby_web.html
db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml
Modified: db/derby/site/trunk/build/site/papers/derby_web.html
URL: http://svn.apache.org/viewvc/db/derby/site/trunk/build/site/papers/derby_web.html?rev=410391&r1=410390&r2=410391&view=diff
==============================================================================
--- db/derby/site/trunk/build/site/papers/derby_web.html (original)
+++ db/derby/site/trunk/build/site/papers/derby_web.html Tue May 30 15:12:40 2006
@@ -133,6 +133,9 @@
<a href="#Add+your+new+page+to+the+seed+site">Add your new page to the seed site</a>
</li>
<li>
+<a href="#What+editor+can+you+use+for+Forrest+XML%3F">What editor can you use for Forrest XML?</a>
+</li>
+<li>
<a href="#Resolve+Forrest+DTDs+locally">Resolve Forrest DTDs locally</a>
</li>
</ul>
@@ -426,7 +429,21 @@
source file. </li>
</ul>
-<a name="N1013C"></a><a name="Resolve+Forrest+DTDs+locally"></a>
+<a name="N1013C"></a><a name="What+editor+can+you+use+for+Forrest+XML%3F"></a>
+<h3 class="boxed">What editor can you use for Forrest XML?</h3>
+<p>
+The Forrest web site mentions jEdit, oXygen, xmlspy,
+and XMLmind XML Editor (XXE) -- and no doubt many more XML products also work.
+One Derby community cohort has recently started using
+<a class="external" href="http://www.jedit.org">jEdit</a> with the jEdit XML plugin and
+it works great
+(<a class="external" href="http://forrest.apache.org/docs_0_70/catalog.html#jedit">see the
+Forrest jEdit configuration instructions</a>).
+If you find other tools that also work well, please let others know
+by posting to
+<a href="../derby_mail.html">derby-dev@db.apache.org</a>.
+</p>
+<a name="N10152"></a><a name="Resolve+Forrest+DTDs+locally"></a>
<h3 class="boxed">Resolve Forrest DTDs locally</h3>
<p>
Many source files in the Derby web site repository are in Forrest XML format.
@@ -459,14 +476,14 @@
-<a name="N1015B"></a><a name="Updating+the+Apache+Derby+web+site"></a>
+<a name="N10171"></a><a name="Updating+the+Apache+Derby+web+site"></a>
<h2 class="boxed">Updating the Apache Derby web site </h2>
<div class="section">
<p>
The information in this section is intended for committers
who need to add a page to the Derby web site or modify an existing page.
</p>
-<a name="N10164"></a><a name="1.+Install+Forrest+on+your+machine"></a>
+<a name="N1017A"></a><a name="1.+Install+Forrest+on+your+machine"></a>
<h3 class="boxed">1. Install Forrest on your machine</h3>
<p>
If you haven't installed Forrest yet,
@@ -476,7 +493,7 @@
as described in the previous section,
and play with it to get comfortable working with Forrest.
</p>
-<a name="N10172"></a><a name="2.+Check+out+the+Derby+web+site+pages"></a>
+<a name="N10188"></a><a name="2.+Check+out+the+Derby+web+site+pages"></a>
<h3 class="boxed">2. Check out the Derby web site pages </h3>
<p>
Check the Derby web site files out of the Subversion repository:
@@ -484,7 +501,7 @@
<pre class="code">
svn co https://svn.apache.org/repos/asf/db/derby/site/trunk
</pre>
-<a name="N10180"></a><a name="3.+Modify+files+in+the+src+tree"></a>
+<a name="N10196"></a><a name="3.+Modify+files+in+the+src+tree"></a>
<h3 class="boxed">3. Modify files in the src tree </h3>
<p>
Source files are in the places listed below:
@@ -563,7 +580,7 @@
</li>
</ul>
-<a name="N1020A"></a><a name="4.+Build+the+site"></a>
+<a name="N10220"></a><a name="4.+Build+the+site"></a>
<h3 class="boxed">4. Build the site </h3>
<p>
After modifying files, you need to rebuild the site with the
@@ -581,7 +598,7 @@
build/site/releases so that they can be checked into subversion with the source
changes.
</p>
-<a name="N10224"></a><a name="5.+Test+the+changes"></a>
+<a name="N1023A"></a><a name="5.+Test+the+changes"></a>
<h3 class="boxed">5. Test the changes </h3>
<p>
There are a couple ways (at least) to review changes.
@@ -616,7 +633,7 @@
won't be added when the site is viewed locally.</a>
</p>
-<a name="N10256"></a><a name="odd_diffs"></a>
+<a name="N1026C"></a><a name="odd_diffs"></a>
<h3 class="boxed">6. Odd diffs under build/site/skin and build/site/papers explained (sort of) </h3>
<p>
Forrest generates inconsistent line endings on Windows machines
@@ -644,7 +661,7 @@
<a href="../derby_mail.html">derby-dev@db.apache.org</a>
if a particular file should be committed or not.
</p>
-<a name="N10287"></a><a name="7.+Commit+changes+to+the+src+and+build%2Fsite+directories"></a>
+<a name="N1029D"></a><a name="7.+Commit+changes+to+the+src+and+build%2Fsite+directories"></a>
<h3 class="boxed">7. Commit changes to the src and build/site directories</h3>
<p>
Commit modified pages in the <span class="codefrag">src</span> and
@@ -686,7 +703,7 @@
<pre class="code">
svn commit --message "here is my commit message" src build/site
</pre>
-<a name="N102CC"></a><a name="8.+Make+web+site+changes+visible"></a>
+<a name="N102E2"></a><a name="8.+Make+web+site+changes+visible"></a>
<h3 class="boxed">8. Make web site changes visible</h3>
<p>
A Derby committer can make web site changes visible as follows:
@@ -700,7 +717,7 @@
www.apache.org automatically syncs up with people.apache.org every couple hours
(the specific schedule could change).
</p>
-<a name="N102E0"></a><a name="9.+Considering+a+quick+fix+to+the+build+tree%3F"></a>
+<a name="N102F6"></a><a name="9.+Considering+a+quick+fix+to+the+build+tree%3F"></a>
<h3 class="boxed">9. Considering a quick fix to the build tree?</h3>
<p>
If you modify a file in the <span class="codefrag">build/site</span> tree,
@@ -709,7 +726,7 @@
will likely overwrite your changes to the build tree.
</p>
<p>
-<em>Last updated May 26, 2006</em>
+<em>Last updated May 30, 2006</em>
</p>
</div>
Modified: db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml
URL: http://svn.apache.org/viewvc/db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml?rev=410391&r1=410390&r2=410391&view=diff
==============================================================================
--- db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml (original)
+++ db/derby/site/trunk/src/documentation/content/xdocs/papers/derby_web.xml Tue May 30 15:12:40 2006
@@ -246,6 +246,22 @@
</section>
<section>
+<title>What editor can you use for Forrest XML?</title>
+<p>
+The Forrest web site mentions jEdit, oXygen, xmlspy,
+and XMLmind XML Editor (XXE) -- and no doubt many more XML products also work.
+One Derby community cohort has recently started using
+<a href="http://www.jedit.org">jEdit</a> with the jEdit XML plugin and
+it works great
+(<a href="http://forrest.apache.org/docs_0_70/catalog.html#jedit">see the
+Forrest jEdit configuration instructions</a>).
+If you find other tools that also work well, please let others know
+by posting to
+<a href="../derby_mail.html">derby-dev@db.apache.org</a>.
+</p>
+</section>
+
+<section>
<title>Resolve Forrest DTDs locally</title>
<p>
@@ -564,7 +580,7 @@
</section>
-<p><em>Last updated May 26, 2006</em></p>
+<p><em>Last updated May 30, 2006</em></p>
</section>
</body>