You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by fe...@apache.org on 2010/08/09 16:05:39 UTC
svn commit: r983652 - in /directory/sandbox/felixk/apacheds-docs: ./ src/
src/docbkx/ src/docbkx/media/ src/main/ src/main/java/ src/main/resources/
src/test/ src/test/java/ src/test/resources/
Author: felixk
Date: Mon Aug 9 14:05:38 2010
New Revision: 983652
URL: http://svn.apache.org/viewvc?rev=983652&view=rev
Log:
Some tryouts with docbook (docbkx)
Added:
directory/sandbox/felixk/apacheds-docs/
directory/sandbox/felixk/apacheds-docs/pom.xml (with props)
directory/sandbox/felixk/apacheds-docs/src/
directory/sandbox/felixk/apacheds-docs/src/docbkx/
directory/sandbox/felixk/apacheds-docs/src/docbkx/basic_user_guide.xml (with props)
directory/sandbox/felixk/apacheds-docs/src/docbkx/book.xml (with props)
directory/sandbox/felixk/apacheds-docs/src/docbkx/media/
directory/sandbox/felixk/apacheds-docs/src/docbkx/media/email.png (with props)
directory/sandbox/felixk/apacheds-docs/src/main/
directory/sandbox/felixk/apacheds-docs/src/main/java/
directory/sandbox/felixk/apacheds-docs/src/main/resources/
directory/sandbox/felixk/apacheds-docs/src/test/
directory/sandbox/felixk/apacheds-docs/src/test/java/
directory/sandbox/felixk/apacheds-docs/src/test/resources/
Added: directory/sandbox/felixk/apacheds-docs/pom.xml
URL: http://svn.apache.org/viewvc/directory/sandbox/felixk/apacheds-docs/pom.xml?rev=983652&view=auto
==============================================================================
--- directory/sandbox/felixk/apacheds-docs/pom.xml (added)
+++ directory/sandbox/felixk/apacheds-docs/pom.xml Mon Aug 9 14:05:38 2010
@@ -0,0 +1,74 @@
+<project
+ xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+
+ <modelVersion>4.0.0</modelVersion>
+ <parent>
+ <artifactId>apacheds-parent</artifactId>
+ <groupId>org.apache.directory.server</groupId>
+ <version>1.5.8-SNAPSHOT</version>
+ </parent>
+ <groupId>org.apache.directory.server</groupId>
+ <artifactId>documentation</artifactId>
+ <version>1.5.8-SNAPSHOT</version>
+
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>com.agilejava.docbkx</groupId>
+ <artifactId>docbkx-maven-plugin</artifactId>
+ <dependencies>
+ <dependency>
+ <groupId>org.docbook</groupId>
+ <artifactId>docbook-xml</artifactId>
+ <version>4.4</version>
+ <scope>runtime</scope>
+ </dependency>
+ </dependencies>
+ <executions>
+ <execution>
+ <phase>pre-site</phase>
+ <goals>
+ <goal>generate-html</goal>
+ <goal>generate-pdf</goal>
+ </goals>
+ <configuration>
+ <!-- per execution configuration -->
+ <includes>book.xml</includes>
+ <draftMode>yes</draftMode>
+ </configuration>
+ </execution>
+ </executions>
+ <configuration>
+ <!-- shared configuration -->
+ <!--
+ <generatedSourceDirectory>\${project.build.directory}/docbkx/generated</generatedSourceDirectory>
+ -->
+ <xincludeSupported>true</xincludeSupported>
+ <paperType>A4</paperType>
+ <fop1Extensions>1</fop1Extensions>
+ <!--
+ <foCustomization>src/docbkx-stylesheet/fo/docbook.xsl</foCustomization> <customizationParameters>
+ <parameter> <name>key</name> <value>value</value> </parameter> </customizationParameters>
+ -->
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+
+ <repositories>
+ <repository>
+ <id>apache.snapshots</id>
+ <name>Apache Development Snapshot Repository</name>
+ <url>https://repository.apache.org/content/repositories/snapshots/</url>
+ <releases>
+ <enabled>false</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+
+</project>
Propchange: directory/sandbox/felixk/apacheds-docs/pom.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: directory/sandbox/felixk/apacheds-docs/src/docbkx/basic_user_guide.xml
URL: http://svn.apache.org/viewvc/directory/sandbox/felixk/apacheds-docs/src/docbkx/basic_user_guide.xml?rev=983652&view=auto
==============================================================================
--- directory/sandbox/felixk/apacheds-docs/src/docbkx/basic_user_guide.xml (added)
+++ directory/sandbox/felixk/apacheds-docs/src/docbkx/basic_user_guide.xml Mon Aug 9 14:05:38 2010
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter version="5.0"
+ xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xmlns:ns5="http://www.w3.org/2000/svg"
+ xmlns:ns4="http://www.w3.org/1998/Math/MathML"
+ xmlns:ns3="http://www.w3.org/1999/xhtml"
+ xmlns:db="http://docbook.org/ns/docbook"
+ xml:lang="en">
+<title>Basic User's Guide</title>
+ <para> Work in progress
+Unfortunately the Basic User's Guide for ApacheDS 1.5 is not finished yet. We have started to move and revise the content, things you find here are work in progress but should be valid for ApacheDS 1.5.5. In the meantime you can have a look at the ApacheDS 1.0 Basic User's Guide, which is currently more complete.</para>
+ <section><title>About this guide</title>
+ <para>Getting started. Learn how to download and install ApacheDS 1.5 on different platforms, connect to it with various clients (graphical tools among others), manipulate the data within your directory and integrate ApacheDS with other software. The same sample data, provided as a download, is used through the whole guide.</para>
+ <example> ... </example>
+ </section>
+ <section><title>Audience</title>
+ <para>This guide is primarily for people new to ApacheDS. If you plan to use the server as is, maybe even for your first LDAP experience, you'll (hopefully) find all information necessary to do so. Only basic configuration tasks are covered. Learn more about the options you have (and many other things) in the ApacheDS v1.5 Advanced User's Guide.</para></section>
+<section><title>Feedback welcome!</title>
+<para>We are quite interested to improve the content of this guide. Feel free to provide us feedback:
+<mediaobject><imageobject>
+<imagedata fileref="media/email.png"></imagedata></imageobject></mediaobject><email>users@directory.apache.org</email></para></section>
+
+</chapter>
Propchange: directory/sandbox/felixk/apacheds-docs/src/docbkx/basic_user_guide.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: directory/sandbox/felixk/apacheds-docs/src/docbkx/book.xml
URL: http://svn.apache.org/viewvc/directory/sandbox/felixk/apacheds-docs/src/docbkx/book.xml?rev=983652&view=auto
==============================================================================
--- directory/sandbox/felixk/apacheds-docs/src/docbkx/book.xml (added)
+++ directory/sandbox/felixk/apacheds-docs/src/docbkx/book.xml Mon Aug 9 14:05:38 2010
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<book version="5.0"
+ xmlns="http://docbook.org/ns/docbook"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xmlns:ns5="http://www.w3.org/2000/svg"
+ xmlns:ns4="http://www.w3.org/1998/Math/MathML"
+ xmlns:ns3="http://www.w3.org/1999/xhtml"
+ xmlns:db="http://docbook.org/ns/docbook"
+ xml:lang="en">
+<info>
+ <title>ApacheDS Basic User Guide v<?eval ${project.version}?></title>
+ <copyright><year>2003-2010</year><holder>The Apache Software Foundation</holder></copyright>
+</info>
+<preface><title>Work in progress</title><db:para>
+Unfortunately the Basic User's Guide for ApacheDS 1.5 is not finished yet. We have started to move and revise the content, things you find here are work in progress but should be valid for ApacheDS 1.5.5. In the meantime you can have a look at the ApacheDS 1.0 Basic User's Guide, which is currently more complete.
+</db:para></preface>
+ <xi:include href="basic_user_guide.xml" />
+
+<chapter>
+<title>My Chapter</title>
+ <para> ... </para>
+ <section><title>First Section</title>
+ <para> ... </para>
+ <example> ... </example>
+ </section>
+
+</chapter>
+<index> ... </index>
+
+</book>
Propchange: directory/sandbox/felixk/apacheds-docs/src/docbkx/book.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: directory/sandbox/felixk/apacheds-docs/src/docbkx/media/email.png
URL: http://svn.apache.org/viewvc/directory/sandbox/felixk/apacheds-docs/src/docbkx/media/email.png?rev=983652&view=auto
==============================================================================
Binary file - no diff available.
Propchange: directory/sandbox/felixk/apacheds-docs/src/docbkx/media/email.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Re: Two questions
Posted by Kiran Ayyagari <ka...@apache.org>.
On Tue, Aug 17, 2010 at 11:58 PM, <fe...@gdls.com> wrote:
>
> With appolgies for the "new guy" questions...
>
> I can't figure out how to search the dev message archives. Is there a
> mechanism?
>
> I'm particularly interested in seeing full-featured Kerberos and in looking
> through the code and the pending issues I'm curious as to the planned
> approach for the way the Kerberos service will use the LDAP. I haven't
the module named protocol-kerberos contains all the kerberos related
implementation
classes [1]
> found mention of it (thus the reference to searching the message archives)
> but has there been any consideration of the draft LDAP Schema that the
> Kerberos WG was developing a few years ago (which seems to have stagnated)?
am not sure about this
Kiran Ayyagari
[1] http://svn.apache.org/repos/asf/directory/apacheds/trunk/protocol-kerberos
Re: svn commit: r983652 - in /directory/sandbox/felixk/apacheds-docs:
./ src/ src/docbkx/ src/docbkx/media/ src/main/ src/main/java/ src/main/resources/
src/test/ src/test/java/ src/test/resources/
Posted by Felix Knecht <fe...@apache.org>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
> Hm, in my tests I didn't add a docbook dependency at all. I committed
> to my sandbox.
Your right, mine works as well without any docbook dependency declared.
I did it the hard way, no archetype [2]
Felix
[2] http://docbkx-tools.sourceforge.net/docbkx-samples/manual.html
>
> I used this example [1], there is no docbook dependency declared at
> all. Not sure how it works...
>
> Kind Regards,
> Stefan
>
> [1] http://code.google.com/p/docbkx-tools/wiki/UsingArchetypeTemplate
>
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.16 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
iEYEARECAAYFAkxgdMQACgkQ2lZVCB08qHHxNQCfYJGvEN+z4BPyj0/CFGIfqSg8
Zi0Aniojs6q9tXA/eZtoKOjk5cNg6Qqm
=ANLZ
-----END PGP SIGNATURE-----
Re: Two questions
Posted by Felix Knecht <fe...@apache.org>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On 08/17/10 20:28, feezelr@gdls.com wrote:
> With appolgies for the "new guy" questions...
>
> I can't figure out how to search the dev message archives. Is there a
> mechanism?
You can use e.g. the markmail archives to search it:
http://directory.markmail.org/search/?q=+list%3Aorg.apache.directory.dev
e.g. search for kerberos:
http://directory.markmail.org/search/?q=+list%3Aorg.apache.directory.dev+kerberos
HTH
Felix
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.16 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
iEYEARECAAYFAkxq5McACgkQ2lZVCB08qHHhBgCfbixK+C08z11IXvpFptu02Ah1
rbIAnjPNJGPYoXq8icMdSv4a9hZPU/2E
=IBo0
-----END PGP SIGNATURE-----
Two questions
Posted by fe...@gdls.com.
With appolgies for the "new guy" questions...
I can't figure out how to search the dev message archives. Is there a
mechanism?
I'm particularly interested in seeing full-featured Kerberos and in
looking through the code and the pending issues I'm curious as to the
planned approach for the way the Kerberos service will use the LDAP. I
haven't found mention of it (thus the reference to searching the message
archives) but has there been any consideration of the draft LDAP Schema
that the Kerberos WG was developing a few years ago (which seems to have
stagnated)?
Thanks,
Richard
.
This is an e-mail from General Dynamics Land Systems. It is for the intended recipient only and may contain confidential and privileged information. No one else may read, print, store, copy, forward or act in reliance on it or its attachments. If you are not the intended recipient, please return this message to the sender and delete the message and any attachments from your computer. Your cooperation is appreciated.
Re: svn commit: r983652 - in /directory/sandbox/felixk/apacheds-docs:
./ src/ src/docbkx/ src/docbkx/media/ src/main/ src/main/java/
src/main/resources/ src/test/ src/test/java/ src/test/resources/
Posted by Stefan Seelmann <se...@apache.org>.
>> I just wonder why you include docbook version 4.4? Can't we use 5.0?
>
> If you know which mvn binary repository provides the 5.0 version I'm
> happy to use it. But I haven't found it yet. The only 5.0 stuff I found
> is a pom.xml without any jars ...
Hm, in my tests I didn't add a docbook dependency at all. I committed
to my sandbox.
I used this example [1], there is no docbook dependency declared at
all. Not sure how it works...
Kind Regards,
Stefan
[1] http://code.google.com/p/docbkx-tools/wiki/UsingArchetypeTemplate
Re: svn commit: r983652 - in /directory/sandbox/felixk/apacheds-docs:
./ src/ src/docbkx/ src/docbkx/media/ src/main/ src/main/java/ src/main/resources/
src/test/ src/test/java/ src/test/resources/
Posted by Felix Knecht <fe...@apache.org>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Hi Stefan
>> + <build>
>> + <plugins>
>> + <plugin>
>> + <groupId>com.agilejava.docbkx</groupId>
>> + <artifactId>docbkx-maven-plugin</artifactId>
>> + <dependencies>
>> + <dependency>
>> + <groupId>org.docbook</groupId>
>> + <artifactId>docbook-xml</artifactId>
>> + <version>4.4</version>
>> + <scope>runtime</scope>
>> + </dependency>
>
> I just wonder why you include docbook version 4.4? Can't we use 5.0?
If you know which mvn binary repository provides the 5.0 version I'm
happy to use it. But I haven't found it yet. The only 5.0 stuff I found
is a pom.xml without any jars ...
Would this be the solution
(http://www.mail-archive.com/docbook@lists.oasis-open.org/msg05548.html)?
<dependency>
<groupId>net.sf.docbook</groupId>
<artifactId>docbook-xml</artifactId>
<version>5.0-all</version>
<classifier>resources</classifier>
<type>zip</type>
<scope>runtime</scope>
</dependency>
Thanks
Felix
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.16 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
iEYEARECAAYFAkxgaLAACgkQ2lZVCB08qHEQjgCeLA7TEYbdDdd1uHcuPhytMePp
9k0AniOIXwGKF4//6r/a3E7vCh+9MblO
=5Ih8
-----END PGP SIGNATURE-----
Re: svn commit: r983652 - in /directory/sandbox/felixk/apacheds-docs:
./ src/ src/docbkx/ src/docbkx/media/ src/main/ src/main/java/
src/main/resources/ src/test/ src/test/java/ src/test/resources/
Posted by Stefan Seelmann <se...@apache.org>.
Hi Felix,
> + <build>
> + <plugins>
> + <plugin>
> + <groupId>com.agilejava.docbkx</groupId>
> + <artifactId>docbkx-maven-plugin</artifactId>
> + <dependencies>
> + <dependency>
> + <groupId>org.docbook</groupId>
> + <artifactId>docbook-xml</artifactId>
> + <version>4.4</version>
> + <scope>runtime</scope>
> + </dependency>
I just wonder why you include docbook version 4.4? Can't we use 5.0?
Kind Regards,
Stefan
Re: svn commit: r983652 - in /directory/sandbox/felixk/apacheds-docs:
./ src/ src/docbkx/ src/docbkx/media/ src/main/ src/main/java/
src/main/resources/ src/test/ src/test/java/ src/test/resources/
Posted by Stefan Seelmann <se...@apache.org>.
Funny, I also played with docbkx last weekend, looks quite good.
On Mon, Aug 9, 2010 at 4:05 PM, <fe...@apache.org> wrote:
> Author: felixk
> Date: Mon Aug 9 14:05:38 2010
> New Revision: 983652
>
> URL: http://svn.apache.org/viewvc?rev=983652&view=rev
> Log:
> Some tryouts with docbook (docbkx)