mirror of https://github.com/apache/ant-ivy
62 lines
3.3 KiB
HTML
62 lines
3.3 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you under the Apache License, Version 2.0 (the
|
|
"License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing,
|
|
software distributed under the License is distributed on an
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
KIND, either express or implied. See the License for the
|
|
specific language governing permissions and limitations
|
|
under the License.
|
|
-->
|
|
<html>
|
|
<head>
|
|
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
|
|
<script type="text/javascript">var xookiConfig = {level: 0};</script>
|
|
<script type="text/javascript" src="xooki/xooki.js"></script>
|
|
</head>
|
|
<body>
|
|
<textarea id="xooki-source">
|
|
Writing documentation for Ivy is pretty simple.
|
|
|
|
The documentation engine used is called <a href="http://xooki.sourceforge.net">xooki</a>, and allows to edit pages while you browse them as soon as you browse them offline (and thus can actually save your modifications).
|
|
|
|
To browse the doc offline, we recommend to check it out from svn:
|
|
<code>
|
|
svn co https://svn.apache.org/repos/asf/incubator/ivy/core/trunk/doc ivy-doc
|
|
</code>
|
|
Then open the index.html file, and you will browse the web site exactly as when you're online, except that you will see a small toolbar at the uper right, allowing to edit the page, save it, move the page in the TOC, create a child, and so on:
|
|
|
|
<center><img src="images/xooki-toolbar.png"/></center>
|
|
<br/><br/>
|
|
When you choose edit you will see a pretty familiar textbox where you can edit the page source.
|
|
|
|
<center><a href="images/xooki-edit.png"><img src="images/xooki-edit-small.png"/></a></center>
|
|
<br/><br/>
|
|
The source uses a format very familiar to those who sometimes write html. Indeed any html is allowed. But you also have some shortcuts and neat syntax.
|
|
|
|
First, line breaks are automatically recognized, so you don't have to put br everywhere.
|
|
Another interesting thing is the code fragment:
|
|
<code>
|
|
<code>
|
|
any text including <tags/>
|
|
</code>
|
|
</code>
|
|
Very helpful to avoid escaping all xml with lt and gt.
|
|
|
|
Finally, URLs are automatically recognized and convert to links, jira issues like IVY-202 are recognized too, and you can use a neat format to reference any ant ivy ant task like [[ant:import]], or also reference svn page easily like [[svn:build.xml this link to build.xml]]. And you can also link to another page by providing its id (i.e. its url without the base and the .html) like the [[index]] or the [[doc/reference]].
|
|
Feel free to edit this page to get a good overview of what is possible.
|
|
|
|
And do not forget to save your changes before the page! Then you can use your favorite IDE and compute a patch for what you changed, and submit this patch by attaching it to a jira issue, or simply sending it to the ivy-dev [[mailing-lists mailing list]].</textarea>
|
|
<script type="text/javascript">xooki.postProcess();</script>
|
|
</body>
|
|
</html>
|