Daisy documentation

java.util.Date

JAVA_HOME
For Windows:
%JAVA_HOME%/bin/java -version

For Linux:
$JAVA_HOME/bin/java -version
java version "1.5.0"

or

java version "1.6.0"
mysql -uroot -pYourRootPassword
IDENTIFIED BY
CREATE DATABASE daisyrepository CHARACTER SET 'utf8';
GRANT ALL ON daisyrepository.* TO daisy@'%' IDENTIFIED BY 'daisy';
GRANT ALL ON daisyrepository.* TO daisy@localhost IDENTIFIED BY 'daisy';
CREATE DATABASE activemq CHARACTER SET 'utf8';
GRANT ALL ON activemq.* TO activemq@'%' IDENTIFIED BY 'activemq';
GRANT ALL ON activemq.* TO activemq@localhost IDENTIFIED BY 'activemq';
.tar.gz
tar xvzf daisy-<version>.tar.gz
.zip
daisy-<version>
DAISY_HOME
Windows:
set DAISY_HOME=c:\daisy-2.1

Linux:
export DAISY_HOME=/home/daisy_user/daisy-2.1
<DAISY_HOME>/install
daisy-repository-init
DAISY_HOME
<DAISY_HOME>/repository-server/bin
daisy-repository-server <location-of-daisy-data-dir>
<location-of-daisy-data-dir>
Daisy repository server started [timestamp]
DAISY_HOME
<DAISY_HOME>/install
daisy-wiki-init
DAISY_HOME
<DAISY_HOME>/install
daisy-wikidata-init
DAISY_HOME
<DAISY_HOME>/install
daisy-wiki-add-site <location of wikidata directory>
DAISY_HOME
<DAISY_HOME>/daisywiki/bin
daisy-wiki <location of wikidata directory>
<DAISY_HOME>/daisywiki/webapp
http://localhost:8888/
$MyField[2][3]
$MyField[*][3]
matchesPath(Concat(ContextDoc(link), '/**'))
${...}
org.outerj.daisy.authentication => org.outerj.daisy.authentication.spi
shiftHeaders
assembleBook
<
>
<DAISY_HOME>
DAISY_HOME
[Windows]
set DAISY_HOME=c:\path\to\daisy-2.1
[Linux]
export DAISY_HOME=/path/to/daisy-2.1
<DAISY_HOME>/repository-server/conf/repository-log4j.properties
<REPO DATA DIR>/conf/
cd <DAISY_HOME>/misc
mysql -Ddaisyrepository -udaisy -ppassword < daisy-2_0-to-2_1.sql
-uroot
-udaisy
-p
<wiki data dir>/daisy.xconf
<component
    class="org.outerj.daisy.frontend.GuestRepositoryProviderImpl"
    role="org.outerj.daisy.frontend.GuestRepositoryProvider"
    logger="daisy">
    <guestUser login="guest" password="guest"/>
</component>
<daisydata dir>/conf/activemq-conf.xml
<property name="poolPreparedStatements" value="true"/>
<DAISY_HOME>/daisywiki/conf/jetty-daisywiki.xml
[Windows]
cd <DAISY_HOME>\install
daisy-wiki-init

[Linux]
cd <DAISY_HOME>/install
./daisy-wiki-init
<
>
<DAISY_HOME>
DAISY_HOME
[Windows]
set DAISY_HOME=c:\path\to\daisy-2.1
[Linux]
export DAISY_HOME=/path/to/daisy-2.1
svn co http://svn.cocoondev.org/repos/daisy/trunk/daisy

svn co http://svn.cocoondev.org/repos/daisy/tags/RELEASE_1_3_1 daisy
    <dependency>
      <groupId>lucene</groupId>
      <artifactId>lucene</artifactId>
      <version>1.3</version>
    </dependency>
http://www.ibiblio.org/maven/
http://cocoondev.org/repository/
<a>
text/xml
daisy:<document id>
or
daisy:<document id>@<branch id or name>:<language id or name>:<version id>#fragment_id
org.outerj.daisy.repository.HierarchyPath
DoesNotHaveVariant(branch,
language)
select id, name
  where
   InCollection('daisydocs')
   and branch = 'daisydocs-1_3' and language = 'en'
   and DoesNotHaveVariant('daisydocs-1_2', 'en')
select id, name where <conditions> and branch='my_branch' and language='my_lang'
select id, name where <conditions> and branchId = ContextDoc(branchId) and languageId = ContextDoc(languageId)
select id, name where InCollection('daisydocs') and branch = 'daisydocs-1_2' and language = 'en'
select id, name where InCollection('mycollection') order by name
select
  ...
where
  ...
order by
  ...
limit x
option
  ...
select
where
select
where
AND
OR
LIKE
AND
LIKE
BETWEEN
functionName(arg1, arg2, ...)
+
-
*
/
search_last_version
$someLinkField = link
$someLinkField =
ContextDoc(link)
search_last_version
$SomeField[index]
$SomeField[index][index]
$SomeField[*][index]
$SomeField[index].documentId
'''t is mooi weer vandaag'
'daisy:docid'               (assumes branch main and language default)
'daisy:docid@branch'        (assumes language default)
'daisy:docid@branch:lang'   (branch can be left blank which defaults to main branch)
$someLinkField = 'daisy:35'
$fieldName has all (value1, value2, value3, ...)
$fieldName has exactly (value1, value2, value3, ...)
$fieldName has some (value1, value2, value3, ...)
or
$fieldName has any (value1, value2, value3, ...)
has some
has any
$fieldName has none (value1, value2, value3, ...)
is null
is not
null
matchesPath
$fieldName matchesPath('/A/B/C')
$fieldName matchesPath('A/B/C')  -> the initial slash is optional
matchesPath('daisy:10-FOO/daisy:11-FOO')
$fieldName matchesPath('/A/*')
$fieldName matchesPath('/A/*/*')
$fieldName matchesPath('/A/*/B')
$fieldName matchesPath('/*/*/*')  -> finds all hierarchical paths of length 3
$fieldName matchesPath('/*/*/**') -> finds all hierarchical paths of at least length 3
$fieldName matchesPath('/A/**')   -> finds all paths of any lenght starting on A
                                     thus e.g. A/B, A/B/C or A/B/C/D.
$fieldName matchesPath('**/A')    -> finds all paths ending on A
$fieldName matchesPath($anotherField, '/**'))

$fieldName matchesPath(Concat(ContextDoc(link), '/**'))

An example taken from Daisy's own knowledge base:
$fieldName matchesPath(String(ReversePath(
              GetLinkPath('KnowlegeBaseCategoryParent', 'true', ContextDoc(link)))))
matchesPath
Path
$fieldName has all ( Path('/A/B/C'), Path('/X/Y/Z') )
[link expression]=>[identifier]

select name, $SomeLinkField=>name where $SomeLinkField=>name like 'A%' order by $SomeLinkField=>name
$SomeLink=>$SomeOtherLink=>name
$SomeLink=>$SomeLink=>$SomeLink=>name
InCollection('collectionname' [, collectionname, collectionname])
AND
InCollection('collection1') and
InCollection('collection2')
OR
InCollection
InCollection
collections
has some
has all
has none
InCollection
LinksTo(documentId, inLastVersion, inLiveVersion [, linktypes])
LinksFrom(documentId, inLastVersion, inLiveVersion [, linktypes])
LinksToVariant(documentId, branch, language, inLastVersion, inLiveVersion [, linktypes])
LinksFromVariant(documentId, branch, language, inLastVersion, inLiveVersion [, linktypes])
inLastVersion
inLiveVersion
inLastVersion
inLiveVersion
inline
out_of_line
image
include
other
IsLinked()
IsNotLinked()
IsLinked()
IsNotLinked()
HasPart('partTypeName')
HasPartWithMimeType('some mimetype')
HasPartWithMimeType('image/%')
DoestNotHaveVariant(branch, language)
Concat(value1, value2, ...) : string
Length(string) : long
Left(string, length) : string
Right(string, length) : string
Substring(string, position, length) : string
UpperCase(string) : string
LowerCase(string) : string
String(value) : string
CurrentDate(spec?) : date
+/- <num> (days|weeks|months|years)
CurrentDate('- 7 days')
CurrentDateTime(spec?) : date
+/- <num> (seconds|minutes|hours|days|weeks|months|years)
CurrentDateTime('- 3 hours')
start    this     week
end      last     month
         next     year
RelativeDate('start this month')
Mod(number1, number2)
Round(number, scale)
ContextDoc(expression [, position])
ContextDoc(id) -- the id of the context document
ContextDoc($someField) -- the value of a field of the context document
ContextDoc(Concat(name, ' ', $someField))
UserId()  ->  function takes no arguments
Path('/A/B/C')
Path('A/B/C')  -> the initial slash is optional
GetLinkPath(linkFieldName, includeCurrent, linkExpr)
ReversePath(hierarchical-path)
where
... where FullText('word')
or
... where FullText('word') AND <other conditions>
for example:
... where FullText('word') AND $myfield = 'abc' AND InCollection('mycollection')
AND
OR
FullText(...)
FullText()
FullText('word', 1, 0, 0)
FullText
FullText
FullText(lucene query, searchInName, searchInContent, searchInFields, branch, language)
FullText
FullText(lucene query) and branch = 'my_branch' and language = 'my_language'
<html>
  <body>
    <div class="fulltext-fragment">
      ...  full text fragment ... <span class="fulltext-hit">the term</span> ... more text ...
    </div>
    ...
  </body>
</html>
select FullTextFragment() where FullText('word')
select FullTextFragment(5) where FullText('word')
order by
order by
ASC
DESC
select
option
option_name = 'option_value' (, option_name = 'option_value')*
<searchResult styleHint="my hint"
...
select id, name where true
select id, name where name like 'p%' order by creationTime desc limit 10
select id, name, totalSizeOfParts where true order by totalSizeOfParts desc limit 10
select id, name, versionState, versionCreationTime
  where versionState = 'draft' option search_last_version = 'true'
select id, name, lockType, lockOwnerName, lockTimeAcquired, lockDuration
  where lockType is not null
select id, name where HasPartWithMimeType('image/%')
select name where true order by Random()
select name, Length(name) where true order by Length(name) DESC
Daisy:name=FullTextIndexer
optimizeIndex
IndexerStatus
<daisydata dir>/indexstore
Daisy:name=FullTextIndexUpdater
reIndexAllDocuments
reIndexDocuments
select id where HasPartWithMimeType('application/pdf')
ReindexStatus
ReindexStatus
org.apache.activemq:BrokerName=DaisyJMS,Type=Queue,Destination=fullTextIndexerJobs
QueueSize
updateable by user
Confirmed
ConfirmKey
Confirmed
myconfig.xml
<daisy-data-dir>/conf
myconfig.xml
services/ldap-auth
services/ntlm-auth
where
InCollection
InCollection('mycollection')

documentType = 'Navigation' and InCollection('mycollection')

$myfield = 'x' or $myotherfield = 'y'
search_last_version
<DAISY_DATA>/conf/myconfig.xml
myconfig.xml
System.exit()
<repodata dir>/pubreqs/
${
}
<element attribute=”${some expr}”>${some expr}</element>
${id}
<?xml version="1.0"?>
<p:publisherRequest
  xmlns:p="http://outerx.org/daisy/1.0#publisher"
  locale="en-US">

  <p:document id="1-DSY">
    <p:aclInfo/>
    <p:availableVariants/>
    <p:annotatedDocument/>
    <p:annotatedVersionList/>
  </p:document>

</p:publisherRequest>
wget --post-file=pubreq.xml --http-user=testuser@1
     --http-passwd=testuser http://localhost:9263/publisher/request
xmllint --format request | less
<p:aclInfo/>
<p:annotatedDocument [inlineParts="..."] />
<p:annotatedVersionList/>
<p:availableVariants/>
<p:choose>
  <p:when test="...">
     [... any publisher instruction ...]
  </p:when>

  [... more p:when's ...]

  <p:otherwise>
    [... any publisher instruction ...]
  </p:otherwise>
</p:choose>
<p:comments/>
<p:diff contentDiffType="text|html|htmlsource">
  <p:otherDocument id="expr"  branch="expr" language="expr" version="expr"/>
</p:diff>
<p:document id="..." branch="..." language="..." version="...">
  [ ... child instructions ... ]
</p:document>
<p:document field="..." hierarchyElement="...">
  [ ... child instructions ... ]
</p:document>
<p:forEach useLastVersion="true|false">
  <p:query>select ... where ... order by ...</p:query>
  <p:document>
    [ ... child instructions ... ]
  </p:document>
</p:forEach>
<p:forEach useLastVersion="true|false">
  <p:expression [precompile="true|false"] [hierarchyElement="all|an integer"]>...</p:expression>
  <p:document>
    [ ... child instructions ... ]
  </p:document>
</p:forEach>
<p:forEach useLastVersion="true|false">
  <p:expression>$MyField</p:expression>
  <p:document>
    <p:annotatedDocument/>
  </p:document>
</p:forEach>
<p:expression>GetLinkPath('CategoryParent')</p:expression>
<p:group id="expr" catchErrors="true|false">

 [... child instructions ...]

</p:group>
id
catchErrors
<p:ids/>
<p:ids>
  [ zero or more child p:id elements ]
  <p:id>....</p:id>
</p:ids>
<p:if test="...">
  [... child instructions ...]
</p:if>
<p:if test="$MyField > 20">
  ...
</p:if>
<p:myComments/>
<p:navigationTree>
  <p:navigationDocument id="expr" branch="expr" language="expr"/>
  <p:activeDocument id="expr" branch="expr" language="expr"/>
  <p:activePath>expr</p:activePath>
  <p:contextualized>true|false</p:contextualized>
  <p:depth>...</p:depth>
  <p:versionMode>live|last</p:versionMode>
  <p:document>...</p:document>
</p:navigationTree>
<p:navigationTree>
  <p:navigationDocument id="338-DSY"/>
  <p:activeDocument id="${id}" branch="${branch}" language="${language}"/>
</p:navigationTree>
<p:navigationTree>
  <p:navigationDocument id="338-DSY"/>
  <p:document>
    <p:annotatedDocument/>
  </p:document>
</p:navigationTree>
  <p:performFacetedQuery>
    <p:options>
      <p:additionalSelects>
        <p:expression>name</p:expression>
        <p:expression>summary</p:expression>
      </p:additionalSelects>
      <p:defaultConditions>documentType='SimpleDocument'</p:defaultConditions>
      <p:defaultSortOrder>name asc</p:defaultSortOrder>
      <p:queryOptions>
        <p:queryOption name="include_retired" value="true"/>
      </p:queryOptions>
    </p:options>
    <p:facets>
      <p:facet expression="variantLastModifierLogin" maxValues="10" sortOnValue="true" sortAscending="false" type="default">
        <p:properties>
          <p:property name="" value=""/>
        </p:properties>
      </p:facet>
    </p:facets>
  </p:performFacetedQuery>
<p:performQuery>
  <p:query>select ... where ... order by ...</p:query>

  [ optional elements: ]
  <p:extraConditions>...</p:extraConditions>
  <p:document>...</p:document>

</p:performQuery>
<p:preparedDocuments publisherRequestSet="..."
                     displayContext="free string"
                     applyDocumentTypeStyling="true|false">
  <p:navigationDocument id="..." branch="..." language="..."/>
</p:preparedDocuments>
applyDocumentTypeStyling
displayContext
<p:publisherRequest xmlns:p="http://outerx.org/daisy/1.0#publisher">
  <p:prepareDocument/>
  <p:aclInfo/>
  <p:subscriptionInfo/>
</p:publisherRequest>
<p:preparedDocuments applyDocumentTypeSpecificStyling="true|false">

  <p:preparedDocument id="1">
    <p:publisherResponse>
      <d:document ...
    </p:publisherResponse>
  </p:preparedDocument>

  <p:preparedDocument id="2">
    <p:publisherResponse>
      <d:document ...
    </p:publisherResponse>
  </p:preparedDocument>

</p:preparedDocuments>
mapping.xml
<m:publisherMapping xmlns:m="http://outerx.org/daisy/1.0#publishermapping">
  <m:when test="documentType = 'mydoctype'" use="myrequest.xml"/>
  <m:when test="true" use="default.xml"/>
</m:publisherMapping>
inlineParts
<p:publisherRequest
    xmlns:p="http://outerx.org/daisy/1.0#publisher"
    locale="en-US"
    versionMode="live"
    exceptions="throw">

 [... various publisher requests ...]

</p:publisherRequest>
<p:publisherResponse
    xmlns:p="http://outerx.org/daisy/1.0#publisher">

 [... responses to the various requests ...]

</p:publisherResponse>
<p:resolveDocumentIds branch="..." language="...">
  <p:document id="..." branch="..." language="..." version="..."/>
</p:resolveDocumentIds>
<p:resolvedDocumentIds>
  <p:document id="..." branch="..." language="..." version="..." name="..."/>
</p:resolvedDocumentIds>
<p:resolveVariables>
  <p:text>...</p:text>
  ... more p:text elements ...
</p:resolveVariables>
<p:resolvedVariables>
  <p:text>...</p:text>
  ... more p:text elements ...
</p:resolvedVariables>
<p:selectionList fieldType="..." branch="expr" language="expr"/>
<p:shallowAnnotatedVersion/>
<p:subscriptionInfo/>
<p:subscriptionInfo subscribed="true|false"/>
<p:variablesConfig>

  <p:variableSources>
    <p:variableDocument id="..." branch="..." language="..."/>
    [... more p:variableDocument elements ...]
  </p:variableSources>

  <p:variablesInAttributes [allAttributes="true|false"] >
     <p:element name="img" attributes="daisy-caption,alt"/>
     [... more p:element elements ...]
  </p:variablesInAttributes>

</p:variablesConfig>
<p:variablesList/>
<p:variablesList>
  <p:variable name="...">...the value...</p:variable>
  ... more p:variable elements ...
</p:variablesList>
daisy-repository-api-<version>.jar
daisy-repository-xmlschema-bindings-<version>.jar
Repository getRepository(Credentials credentials) throws RepositoryException;
Document createDocument(String name, String documentTypeName);
Document getDocument(long documentId, boolean updateable) throws RepositoryException;
RepositorySchema getRepositorySchema();
AccessManager getAccessManager();
QueryManager getQueryManager();
CollectionManager getCollectionManager();
UserManager getUserManager();
DAISY_HOME/lib/daisy/jars/daisy-repository-api-1.5.jar
DAISY_HOME/lib/daisy/jars/daisy-repository-client-impl-1.5.jar
DAISY_HOME/lib/daisy/jars/daisy-repository-spi-1.5.jar
DAISY_HOME/lib/daisy/jars/daisy-util-1.5.jar
DAISY_HOME/lib/avalon-framework/jars/avalon-framework-api-4.1.5.jar
DAISY_HOME/lib/daisy/jars/daisy-repository-common-impl-1.5.jar
DAISY_HOME/lib/commons-httpclient/jars/commons-httpclient-2.0.2.jar
DAISY_HOME/lib/xmlbeans/jars/xbean-2.1.0.jar
DAISY_HOME/lib/xmlbeans/jars/xmlpublic-2.1.0.jar
DAISY_HOME/lib/stax/jars/stax-api-1.0.jar
DAISY_HOME/lib/daisy/jars/daisy-repository-xmlschema-bindings-1.5.jar
DAISY_HOME/lib/concurrent/jars/concurrent-1.3.2.jar
DAISY_HOME/lib/commons-logging/jars/commons-logging-1.0.4.jar
DAISY_HOME/lib/commons-collections/jars/commons-collections-3.1.jar
DAISY_HOME/lib/daisy/jars/daisy-jmsclient-api-1.5.jar
DAISY_HOME/lib/geronimo-spec/jars/geronimo-spec-jms-1.1-rc4.jar

(below only if you need the htmlcleaner)

DAISY_HOME/lib/daisy/jars/daisy-htmlcleaner-1.5.jar
DAISY_HOME/lib/nekohtml/jars/nekohtml-0.9.5.jar
DAISY_HOME/lib/nekodtd/jars/nekodtd-0.1.11.jar
DAISY_HOME/lib/xerces/jars/xercesImpl-2.6.2.jar
DAISY_HOME/lib/xerces/jars/xmlParserAPIs-2.2.1.jar
package mypackage;

import org.outerj.daisy.repository.RepositoryManager;
import org.outerj.daisy.repository.Credentials;
import org.outerj.daisy.repository.Repository;
import org.outerj.daisy.repository.query.QueryManager;
import org.outerj.daisy.repository.clientimpl.RemoteRepositoryManager;
import org.outerx.daisy.x10.SearchResultDocument;

import java.util.Locale;

public class Search {
    public static void main(String[] args) throws Exception {
        RepositoryManager repositoryManager = new RemoteRepositoryManager(
            "http://localhost:9263", new Credentials("guest", "guest"));
        Repository repository =
            repositoryManager.getRepository(new Credentials("testuser", "testuser"));
        QueryManager queryManager = repository.getQueryManager();

        SearchResultDocument searchresults =
            queryManager.performQuery("select id, name where true", Locale.getDefault());
        SearchResultDocument.SearchResult.Rows.Row[] rows =
            searchresults.getSearchResult().getRows().getRowArray();

        for (int i = 0; i < rows.length; i++) {
            String id = rows[i].getValueArray(0);
            String name = rows[i].getValueArray(1);
            System.out.println(id + " : " + name);
        }

        System.out.println("Total number: " + rows.length);

    }
}
DAISY_HOME/lib/daisy/jars/daisy-jmsclient-impl-1.3.jar
DAISY_HOME/lib/exolabcore/jars/exolabcore-0.3.7.jar
DAISY_HOME/lib/openjms/jars/openjms-client-0.7.6.jar
importPackage(Packages.org.outerj.daisy.repository);
importClass(Packages.org.outerj.daisy.repository.clientimpl.RemoteRepositoryManager);

var repositoryManager = new RemoteRepositoryManager("http://localhost:9263",
                                             new Credentials("guest", "guest"));
var repository = repositoryManager.getRepository(new Credentials("testuser", "testuser"));
importPackage(Packages.org.outerj.daisy.repository);
importClass(Packages.org.outerj.daisy.repository.clientimpl.RemoteRepositoryManager);

var repositoryManager = new RemoteRepositoryManager("http://localhost:9263",
                                                    new Credentials("guest", "guest"));
var repository = repositoryManager.getRepository(new Credentials("testuser", "testuser"));

var document = repository.createDocument("My test image", "Image");
var imageFile = new java.io.File("myimage.gif");
document.setPart("ImageData", "image/gif", new FilePartDataSource(imageFile));
document.save();

print("Document created, ID = " + document.getId());
importPackage(Packages.org.outerj.daisy.repository);
importClass(Packages.org.outerj.daisy.repository.clientimpl.RemoteRepositoryManager);
importPackage(Packages.java.util);

var repositoryManager = new RemoteRepositoryManager("http://localhost:9263",
                                                    new Credentials("guest", "guest"));
var repository = repositoryManager.getRepository(new Credentials("testuser", "testuser"));
var queryManager = repository.getQueryManager();

var searchresults = queryManager.performQuery("select id, name where true", Locale.getDefault());
var rows = searchresults.getSearchResult().getRows().getRowArray();
for (var i = 0; i < rows.length; i++) {
  print(rows[i].getValueArray(0) + " : " + rows[i].getValueArray(1));
}

print("Total number: " + rows.length);
importPackage(Packages.org.outerj.daisy.repository);
importClass(Packages.org.outerj.daisy.repository.clientimpl.RemoteRepositoryManager);

var repositoryManager = new RemoteRepositoryManager("http://localhost:9263",
                                                    new Credentials("guest", "guest"));
var repository = repositoryManager.getRepository(new Credentials("testuser", "testuser"));

// With the UserManager we can manage users and roles
var userManager = repository.getUserManager();

// Get references to some roles, we'll need them in a moment
var guestRole = userManager.getRole("guest", false);
var adminRole = userManager.getRole("Administrator", false);

// check if current user has admin role, and exit if not
var me  = userManager.getUser(repository.getUserId(), false);
var adminRoleId = adminRole.getId();
if (!me.hasRole(adminRoleId))
{
  print ("current user lacks admin rights to add new user. ");
  exit;
}
repository.switchRole(adminRoleId);

// Create the new user
var newUser = userManager.createUser("john");

// The user needs to be added to at least one role
newUser.addToRole(guestRole);
newUser.addToRole(adminRole);

// Optionally, set a default role which will be active after
// logging in. If not set, all roles (with the exception of
// the Administrator role) will be active on login
// newUser.setDefaultRole(guestRole);

// Password is required when using Daisy's built-in authentication scheme
newUser.setPassword("boe");

// Alternatively, set another authentication scheme:
// newUser.setAuthenticationScheme("my-ldap");

// Optional things
newUser.setFirstName("John");
newUser.setLastName("Johnson");

// Setting updateableByUser will allow the user to access the
// user settings page in the Wiki, so that the user can
// update here e-mail
newUser.setUpdateableByUser(true);

newUser.save();
importPackage(Packages.org.outerj.daisy.repository);
importPackage(Packages.org.outerj.daisy.repository.user);
importClass(Packages.org.outerj.daisy.repository.clientimpl.RemoteRepositoryManager);

var repositoryManager = new RemoteRepositoryManager("http://localhost:9263",
                                                    new Credentials("guest", "guest"));
var repository = repositoryManager.getRepository(new Credentials("testuser", "testuser"));
repository.switchRole(Role.ADMINISTRATOR);

var userManager = repository.getUserManager();
var user = userManager.getUser("someuser", true);
user.setPassword("somepwd");
user.save();
http://localhost:9263/repository/query?q=select+id,name+where+true&locale=en
http://localhost:9263/repository/document/99999999
<?xml version="1.0" encoding="UTF-8"?>
<ns:document
  xmlns:ns="http://outerx.org/daisy/1.0"
  name="My test doc"
  typeId="2"
  owner="3"
  validateOnSave="true"
  newVersionState="publish"
  retired="false"
  private="false"
  branchId="1"
  languageId="1"
  >
  <ns:customFields/>
  <ns:collectionIds>
    <ns:collectionId>1</ns:collectionId>
  </ns:collectionIds>
  <ns:fields/>
  <ns:parts>
    <ns:part mimeType="text/xml" typeId="2" dataRef="data1"/>
  </ns:parts>
  <ns:links/>
</ns:document>
<html>
  <body>

    <h1>Hi there!</h1>

    <p>This is a test document.</p>

  </body>
</html>
curl --basic
     --user testuser:testuser
     --form xml=@newdoc.xml
     --form data1=@mynewfile.xml
     http://localhost:9263/repository/document
/repository/document/<document-id>/version/<version-id>/part/<parttype-id>/data
<?xml version="1.0"?>
<fieldType name="myNewField" valueType="string" deprecated="false"
           aclAllowed="false" size="0"
           xmlns="http://outerx.org/daisy/1.0">
  <labels>
    <label locale="">My New Field</label>
  </labels>
  <descriptions>
    <description locale="">This is a test field</description>
  </descriptions>
  <selectionList>
    <staticSelectionList>  
      <listItem>
        <labels/>
        <string>value 1</string>
      </listItem>
      <listItem>
        <labels/>
        <string>value 2</string>
      </listItem>
    </staticSelectionList>
  </selectionList>
</fieldType>
wget --post-file=newfieldtype.xml
     --http-user=testuser@1
     --http-passwd=testuser
     http://localhost:9263/repository/schema/fieldType
xmllint --format fieldType
wget http://localhost:9263/repository/schema/fieldType/1
xmllint --format 1 > updatedfieldtype.xml
<?xml version="1.0" encoding="UTF-8"?>
<ns:fieldType xmlns:ns="http://outerx.org/daisy/1.0" size="0" updateCount="1"
  aclAllowed="false" deprecated="false" valueType="string"
  name="myNewField" lastModifier="3"
  lastModified="2004-09-09T09:06:51.032+02:00" id="1">
  <ns:labels>
    <ns:label locale="">My New Field</ns:label>
  </ns:labels>
  <ns:descriptions>
    <ns:description locale="">This is a test field</ns:description>
  </ns:descriptions>
  <ns:selectionList>
    <ns:staticSelectionList>
      <ns:listItem>
        <ns:labels/>
        <ns:string>value 1</ns:string>
      </ns:listItem>
      <ns:listItem>
        <ns:labels/>
        <ns:string>value 2</ns:string>
      </ns:listItem>
      <ns:listItem>
        <ns:labels/>
        <ns:string>value 3</ns:string>
      </ns:listItem>
    </ns:staticSelectionList>
  </ns:selectionList>
</ns:fieldType>
wget --post-file=updatedfieldtype.xml
     --http-user=testuser@1
     --http-passwd=testuser
     http://localhost:9263/repository/schema/fieldType/1
daisy:import-service
import org.outerj.daisy.textextraction.TextExtractor;
...

TextExtractor extractor = new MyTextExtractor();

pluginRegistry.addPlugin(TextExtractor.class, "my text extractor", extractor);
daisy:import-service
<beans ...

  <daisy:import-service id="pluginRegistry" service="org.outerj.daisy.plugin.PluginRegistry"/>
<daisy data dir>/plugins/load-before-repository

<daisy data dir>/plugins/load-after-repository
<DAISY_HOME>/repository-server/conf/runtime-config.xml
MyExtension myExtension = (MyExtension)repository.getExtension("name-of-the-extension");
org
  foobar
    FixedPasswordAuthenticationScheme.class
DAISY-INF
  spring
    applicationContext.xml
package org.foobar;

import org.outerj.daisy.authentication.AuthenticationScheme;
import org.outerj.daisy.authentication.AuthenticationException;
import org.outerj.daisy.plugin.PluginRegistry;
import org.outerj.daisy.repository.Credentials;
import org.outerj.daisy.repository.user.User;
import org.outerj.daisy.repository.user.UserManager;
import org.apache.avalon.framework.configuration.Configuration;

public class FixedPasswordAuthenticationScheme implements AuthenticationScheme {
    private String name;
    private String description;
    private String password;
    private PluginRegistry pluginRegistry;

    public FixedPasswordAuthenticationScheme(Configuration config,
            PluginRegistry pluginRegistry) throws Exception {
        password = config.getChild("password").getValue();
        name = config.getChild("name").getValue();
        description = config.getChild("description").getValue();
        this.pluginRegistry = pluginRegistry;
        pluginRegistry.addPlugin(AuthenticationScheme.class, name, this);
        System.out.println("Scheme " + name + " added!");
    }

    public void destroy() {
        pluginRegistry.removePlugin(AuthenticationScheme.class, name, this);
    }

    public String getName() {
        return name;
    }

    public String getDescription() {
        return description;
    }

    public boolean check(Credentials credentials) throws AuthenticationException {
        // this is the actual password check, very simple in this case
        return password.equals(credentials.getPassword());
    }

    public void clearCaches() {
        // we have nothing cached
    }

    public User createUser(Credentials crendentials, UserManager userManager) throws AuthenticationException {
        // unsupported
        return null;
    }
}
javac -classpath
          $DAISY_HOME/lib/daisy/jars/daisy-repository-api-<version>.jar:
          $DAISY_HOME/lib/daisy/jars/daisy-repository-server-spi-<version>.jar:
          $DAISY_HOME/lib/daisy/jars/daisy-pluginregistry-api-<version>jar:
          $DAISY_HOME/lib/avalon-framework/jars/avalon-framework-api-4.1.5.jar
      FixedPasswordAuthenticationScheme.java
<?xml version="1.0"?>
<beans              xmlns = "http://www.springframework.org/schema/beans"
                xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
              xmlns:daisy = "http://outerx.org/daisy/1.0#runtime-springext"
               xmlns:conf = "http://outerx.org/daisy/1.0#config-springext"
       xsi:schemaLocation = "http://www.springframework.org/schema/beans
                             http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
                             http://outerx.org/daisy/1.0#runtime-springext
                             http://daisycms.org/schemas/daisyruntime-springext.xsd
                             http://outerx.org/daisy/1.0#config-springext
                             http://daisycms.org/schemas/config-springext.xsd">

  <daisy:import-service id="configurationManager"
             service="org.outerj.daisy.configuration.ConfigurationManager"/>
  <daisy:import-service id="pluginRegistry"
             service="org.outerj.daisy.plugin.PluginRegistry"/>

  <bean id="foo" class="org.foobar.FixedPasswordAuthenticationScheme" destroy-method="destroy">
    <constructor-arg>
      <conf:configuration group="foobar" name="fixedpwd-auth" source="configurationManager">
        <conf:default xmlns="">
          <name>fixedpwd</name>
          <description>Fixed global password</description>
          <password>jamesbond</password>
        </conf:default>
      </conf:configuration>
    </constructor-arg>
    <constructor-arg ref="pluginRegistry"/>
  </bean>

</beans>
<daisy:import>
$ find -type f
./org/foobar/FixedPasswordAuthenticationScheme.class
./DAISY-INF/spring/applicationContext.xml

$ jar cvf fixedpwd-auth.jar *
<repo data
dir>/plugins/load-before-repository
Scheme fixedpwd added!
<?xml version="1.0"?>
<runtime>
  <containers>

    <artifact id="cont1" groupId="foo" artifactId="bar" version="2.1"/>

    <file id="cont2" path="/path/to/file.jar"/>

    <directory id="foo" path="/foo/bar"/>    

  </containers>
</runtime>
${...}
<directory id="something" path="${user.home}${file.separator}/containers"/>
DAISY-INF
 + classloader.xml
 + spring
    + applicationContext.xml
    + ...
.xml
applicationContext.xml
<?xml version="1.0"?>
<beans              xmlns = "http://www.springframework.org/schema/beans"
                xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
              xmlns:daisy = "http://outerx.org/daisy/1.0#runtime-springext"
               xmlns:conf = "http://outerx.org/daisy/1.0#config-springext"
       xsi:schemaLocation = "http://www.springframework.org/schema/beans
                             http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
                             http://outerx.org/daisy/1.0#runtime-springext
                             http://daisycms.org/schemas/daisyruntime-springext.xsd
                             http://outerx.org/daisy/1.0#config-springext
                             http://daisycms.org/schemas/config-springext.xsd">

  <!-- Import and export sample syntax:
  <daisy:import-service id="" service="(interface FQN)"/>
  <daisy:export-service ref="" service="(interface FQN)"/>
  -->

  <!-- Insert bean definitions here -->
</beans>
<?xml version="1.0" encoding="UTF-8"?>
<classloader>
  <classpath>
    <artifact groupId="" artifactId="" version="" share="allowed|required|prohibited"/>
  </classpath>
</classloader>
share
allowed
required
prohibited
--classloader-log
<daisy:export-service ref="mybeanid" service="org.mydomain.MyInterface"/>
<daisy:export-service ref="mybeanid" service="org.mydomain.InterfaceA"/>
<daisy:export-service ref="mybeanid" service="org.mydomain.InterfaceB"/>
<daisy:import-service id="datasource" service="javax.sql.DataSource"/>
cd $DAISY_HOME/repository-server/bin
daisy-repository-server -h
cd <source tree root>/repository/server
start-repository -h
import org.apache.avalon.framework.configuration.Configuration

public class Foo {
    public Foo(Configuration conf) {
       System.out.println(conf.getChild("message").getValue());
    }
}
<beans              xmlns = "http://www.springframework.org/schema/beans"
              xmlns:daisy = "http://outerx.org/daisy/1.0#runtime-springext"
               xmlns:conf = "http://outerx.org/daisy/1.0#config-springext"
       xsi:schemaLocation = "http://www.springframework.org/schema/beans
                             http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
                             http://outerx.org/daisy/1.0#runtime-springext
                             http://daisycms.org/schemas/daisyruntime-springext.xsd
                             http://outerx.org/daisy/1.0#config-springext
                             http://daisycms.org/schemas/config-springext.xsd">

  <daisy:import-service id="configurationManager"
                         service="org.outerj.daisy.configuration.ConfigurationManager"/>

  <bean id="thing1" class="Foo">
    <constructor-arg>
      <conf:configuration group="mythings" name="foo" source="configurationManager"/>
    </constructor-arg>
  </bean>

</beans>
<conf:configuration>
  <bean id="thing1" class="Foo">
    <constructor-arg>
      <conf:configuration group="mythings" name="foo" source="configurationManager">
        <conf:default xmlns="">
          <message>No message configured!</message>
        </conf:default>
      </conf:configuration>
    </constructor-arg>
  </bean>
myconfig.xml
<targets>
  <target path="mythings/foo">
    <configuration>
      <message>Hello world!</message>
    </configuration>
  </target>
</targets>
<target>
<target path="/daisy/repository/blobstore">
services/configuration
-l
-m
start-repository -l debug
start-repository -l debug -m org.outerj.daisy
+ repository
    + api
    + client
    + common
    + server
    + server-spi
    + spi
    + test
    + xmlschema-bindings
// Getting a repository instance
Repository repository = repositoryManager.getRepository(new Credentials("user", "password"));

// Retrieving a document
Document document = repository.getDocument(55, false);

// Creating a collection
CollectionManager collectionManager = repository.getCollectionManager();
DocumentCollection newCollection = collectionManager.createCollection("abc");
newCollection.save();
<wikidata directory>/sites
<siteconf xmlns="http://outerx.org/daisy/1.0#siteconf">
  <title>foobar</title>
  <description>The "foobar" site</description>
  <skin>default</skin>
  <navigationDocId>1-DSY</navigationDocId>
  <homepageDocId>2-DSY</homepageDocId>
  <!-- homepage>....</homepage -->
  <collectionId>1</collectionId>
  <!-- collectionName>myCollection</collectionName -->
  <contextualizedTree>false</contextualizedTree>
  <!-- navigationDepth>4</navigationDepth -->
  <branch>main</branch>
  <language>default</language>
  <defaultDocumentType>SimpleDocument</defaultDocumentType>
  <publisherRequestSet>default</publisherRequestSet>
  <siteSwitching mode="all"/>
  <newVersionStateDefault>publish</newVersionStateDefault>
  <locking>
    <automatic lockType='pessimistic' defaultTime='15' autoExtend='true'/>
  </locking>
  <!--
  <documentTypeFilter>
    <include name="foo*"/>
    <exclude name="bar*"/>
  </documentTypeFilter>
  -->
</siteconf>
ext/something
<include name="*"/>
daisy-wiki-add-site <location of wikidata directory>

daisy:<document id>
for example:
daisy:167
daisy:<document id>@<branch name or id>:<language name or id>:<version id>
daisy:167@::5
<version id>
last
live
daisy:5#notes
<a name="notes"/>
abc / def / ghi
<object>
<embed>
<html>
<body>
<body>
...
  <p:prepareDocument inlineParts="LiteralHtmlData"/>
...
select id, branch, language, name where documentType = 'Navigation'
<d:navigationTree xmlns:d="http://outerx.org/daisy/1.0#navigationspec">
</d:navigationTree>
<d:navigationTree xmlns:d="http://outerx.org/daisy/1.0#navigationspec">
  <d:doc id="26"/>  
  <d:doc id="32">
    <d:doc id="15"/>  
  </d:doc>
</d:navigationTree>
<d:navigationTree xmlns:d="http://outerx.org/daisy/1.0#navigationspec">
  <d:doc id="26" label="Introduction"/>  
  <d:doc id="32" label="Hot Stuff">
    <d:doc id="15" label="Fire"/>
  </d:doc>
</d:navigationTree>
<d:doc id="..." visibility="always|hidden|when-active"/>
<d:navigationTree xmlns:d="http://outerx.org/daisy/1.0#navigationspec">
  <d:doc id="26" label="Introduction"/>  
  <d:doc id="32" label="Hot Stuff">
    <d:doc id="15" label="Fire"/>
  </d:doc>
  <d:link url="http://outerthought.org" label="Outerthought"/>
</d:navigationTree>
<d:link url="http://www.daisycms.org" label="Daisy CMS"
        inheritAclDocId="78-DSY" inheritAclBranch="main" inheritAclLanguage="default"/>
<d:navigationTree xmlns:d="http://outerx.org/daisy/1.0#navigationspec">
  <d:group label="Some title">
    <d:doc id="26" label="Introduction"/>  
    <d:doc id="32" label="Hot Stuff">
      <d:doc id="15" label="Fire"/>
    </d:doc>
  </d:group>
  <d:link url="http://outerthought.org" label="Outerthought"/>
</d:navigationTree>
<d:navigationTree xmlns:d="http://outerx.org/daisy/1.0#navigationspec">
  <d:group label="Some title">
    <d:doc id="26" label="Introduction"/>  
    <d:doc id="32" label="Hot Stuff">
      <d:doc id="15" label="Fire"/>
    </d:doc>
    <d:import docId="81"/>
  </d:group>
  <d:link url="http://outerthought.org" label="Outerthought"/>
</d:navigationTree>
<d:navigationTree xmlns:d="http://outerx.org/daisy/1.0#navigationspec">
  <d:doc id="26" label="Introduction"/>  
  <d:doc id="32" label="Hot Stuff">
    <d:doc id="15" label="Fire"/>
    <d:query q="select name where $somefield='hot'"/>
  </d:doc>
</d:navigationTree>
select documentType, $Category, name where true
<d:query ...>
  <d:column sortOrder="none|ascending|descending" visibility="..."/>
  ... more d:column elements ...
</d:query>

${...}
${documentId}
${branchId}
${languageId}
${1}
${2}
${../1}
$MyStringField = ${3}
${5}
${
\${
<d:query q="select id where documentType = 'Navigation' order by name" useSelectValues="0">
  <d:import docId="${documentId} branch="${branchId}" language="${languageId}"/>
</d:query>
<d:query q="select name where true" useSelectValues="0">
  <d:link label="Search on google for ${1}"
          href="http://www.google.com/search?q=${1}"
</d:query>

<d:separator/>
<d:navigationTree xmlns:d="http://outerx.org/daisy/1.0#navigationspec">
  <d:collections>
    <d:collection name="MyCollection"/>
  </d:collections>
  <d:doc id="26" label="Introduction"/>  
  <d:doc id="32" label="Hot Stuff">
    <d:doc id="15" label="Fire"/>
    <d:query q="select name where $somefield='hot' order by name"/>
  </d:doc>
</d:navigationTree>
<wikidata directory>/sites/<sitedir>/facetednavdefs
<facetedNavigationDefinition xmlns="http://outerx.org/daisy/1.0#facetednavdef">
  <options>
    <limitToSiteCollection>false</limitToSiteCollection>
    <limitToSiteVariant>true</limitToSiteVariant>
    <additionalSelects>
      <expression>variantLastModified</expression>
      <expression>variantLastModifierLogin</expression>
    </additionalSelects>
    <defaultConditions>true</defaultConditions>
    <defaultOrder>documentType ASC, name ASC</defaultOrder>
  </options>
  <facets>
    <facet expression="documentType"/>
    <facet expression="collections"/>
    <facet expression="lastModifierLogin"/>
  </facets>
</facetedNavigationDefinition>
<defaultConditions>$someField = 'abc' and $someOtherField='def'</defaultConditions>
http://localhost:8888/daisy/yoursite/facetedBrowser/test
<facetedNavigationDefinition xmlns="http://outerx.org/daisy/1.0#facetednavdef">
  <optionsList defaultOptions="standard">
    <options id="standard">
      <limitToSiteCollection>false</limitToSiteCollection>
      <limitToSiteVariant>true</limitToSiteVariant>
      <defaultConditions>true</defaultConditions>
    </options>
    <options id="doctype">
      <limitToSiteCollection>false</limitToSiteCollection>
      <limitToSiteVariant>true</limitToSiteVariant>
      <defaultConditions>documentType='{request-param:docType|SimpleDocument}'</defaultConditions>
      <defaultOrder>documentType ASC</defaultOrder>
 </options>
  </optionsList>
  <facets>
    <facet expression="documentType"/>
    <facet expression="collections"/>
    <facet expression="lastModifierLogin"/>
  </facets>
</facetedNavigationDefinition>
http://localhost:8888/daisy/yoursite/facetedBrowser/test?options=doctype
{request-param:docType|SimpleDocument} --> {request-param:request-parameter-name|default-request-parameter-value}
http://localhost:8888/daisy/yoursite/facetedBrowser/test?options=doctype&docType=SomeDocumentType
http://localhost:8888/daisy/yoursite/facetedBrowser/test?activeNavPath=/path/to/facetedBrowser
<facetedNavigationDefinition xmlns="http://outerx.org/daisy/1.0#facetednavdef">
  <stylesheet src="daisyskin:facetednav-styling/myfaceted_browser.xsl"/>
  <options>
   ...
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:d="http://outerx.org/daisy/1.0"
  xmlns:p="http://outerx.org/daisy/1.0#publisher"
  xmlns:n="http://outerx.org/daisy/1.0#navigation"
  xmlns:i18n="http://apache.org/cocoon/i18n/2.1"
  xmlns:daisyutil="xalan://org.outerj.daisy.frontend.util.XslUtil"
  xmlns:urlencoder="xalan://java.net.URLEncoder">  
<!-- Import the original stylesheet -->
  <xsl:import href="daisyskin:xslt/faceted_browser.xsl"/>
<!-- The customization -->
  <xsl:template name="content">
    <h1>My own faceted browser</h1>
    <div class="facetbrowser-resultcount"><xsl:value-of select="d:facetedQueryResult/d:searchResult/d:resultInfo/@size"/> document(s) found.</div>
    <br/>
    <xsl:call-template name="options"/>
    <br/>    
    <br/>
    <xsl:call-template name="results"/>
    <xsl:call-template name="javascript"/>
  </xsl:template>
</xsl:stylesheet>
<daisy_home>/daisywiki/webapp/daisy/resources/skins/default/xslt/faceted_browser.xsl
<facets>  
<!-- A date discrete facet with a parabolic spread. -->
  <facet expression="$SomeDate" type="DATE" threshold="7" spread="2.0">
    <properties>
      <property name="threshold" value="7"/>
      <property name="spread" value="2.0"/>
    </properties>
  </facet>
 <!-- Number discrete facet with a linear spread -->
  <facet expression="$SomeNumber" type="NUMBER">
    <properties>
      <property name="threshold" value="7"/>
    </properties>
  </facet>
  <facet expression="$SomeString" type="STRING">
    <properties>
      <property name="threshold" value="7"/>
    </properties>
  </facet>
</facets>
<siteSwitching>
<siteSwitching mode="stay|all|selected">
  <site>...</site>
  ... more <site> elements ...
</siteSwitching>
stay
all
selected
<site>
<site>
http://host/daisy/mysite/<document-id>

http://host/daisy/mysite/<document-id>.html
<document
    isIncluded="true|false"
    displayContext="standalone|something else"
    xmlns:d="http://outerx.org/daisy/1.0"
    xmlns:p="http://outerx.org/daisy/1.0#publisher">

  <context .../>
  <p:publisherResponse>
    <d:document xmlns:d="http://outerx.org/daisy/1.0"
        id="..."
        name="..."
        [... various other attributes ...] >

      <d:fields>
        <d:field typeId="..." name="..." label="..." valueFormatted="..."
                 [... other attributes and children ...]>
        ... more fields ...
      </d:fields>

      <d:parts>
        <d:part typeId="..." mimeType="..." size="..." label="..." daisyHtml="true/false">
          [... HTML content of the part including html/body if @daisyHtml=true ...]
        </d:part>
        ... more parts ...
      </d:parts>

      <d:links>
        <d:link title="..." target="..."/>
        ... more links ...
      </d:links>

      [... customFields, lockInfo, collectionIds ...]
    </d:document>
  </p:publisherResponse>
</document>
isIncluded
displayContext
<wikidata directory>/resources/skins/<skin-name>/document-styling/<format>
<skin-name>
<format>
html
xslfo
<wikidata directory>/resources/skins/default/document-styling/html
<document-type-name>.xsl
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:d="http://outerx.org/daisy/1.0">

  <xsl:import href="daisyskin:xslt/document-to-html.xsl"/>

  <xsl:template match="d:document">
    <h1 class="daisy-document-name"><xsl:value-of select="@name"/></h1>

    <p>
      Hi there! Here's the value of field1:
      <xsl:value-of select="d:fields/d:field[@name='field1']/@valueFormatted"/>
      and field 2:
      <xsl:value-of select="d:fields/d:field[@name='field2']/@valueFormatted"/>
    </p>

    <xsl:apply-templates select="d:parts/d:part"/>
    <xsl:apply-templates select="d:links"/>
    <!-- xsl:apply-templates select="d:fields"/ -->
  </xsl:template>

</xsl:stylesheet>
<xsl:template match="d:document">
  <h1 class="daisy-document-name"><xsl:value-of select="@name"/></h1>
  <xsl:apply-templates select="d:parts/d:part"/>
  <xsl:apply-templates select="d:links"/>
  <xsl:apply-templates select="d:fields"/>
</xsl:template>
<wikidata directory>/resources/skins/default/document-styling/html/TestDocType.xsl
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:d="http://outerx.org/daisy/1.0">

  <xsl:import href="daisyskin:xslt/document-to-html.xsl"/>

  <xsl:template match="d:document">
    <h1 class="daisy-document-name"><xsl:value-of select="@name"/></h1>

    <div style="margin: 20px; padding: 10px; border: 1px solid black; background-color: #ffd76c">
      <xsl:apply-templates select="d:parts/d:part[@name='Abstract']"/>
    </div>
    <xsl:apply-templates select="d:parts/d:part[@name='Body']"/>

    <xsl:apply-templates select="d:links"/>
    <xsl:apply-templates select="d:fields"/>
  </xsl:template>

</xsl:stylesheet>
<daisydata directory>/pubreqs
<daisydata directory>/pubreqs/foobar
mapping.xml
<?xml version="1.0"?>
<m:publisherMapping xmlns:m="http://outerx.org/daisy/1.0#publishermapping">
  <m:when test="$Category is not null" use="categorized.xml"/>
  <m:when test="true" use="default.xml"/>
</m:publisherMapping>
documentType = 'MyDocType'
<?xml version="1.0"?>
<p:publisherRequest xmlns:p="http://outerx.org/daisy/1.0#publisher">
  <p:prepareDocument/>
  <p:aclInfo/>
  <p:subscriptionInfo/>
</p:publisherRequest>
<?xml version="1.0"?>
<p:publisherRequest xmlns:p="http://outerx.org/daisy/1.0#publisher" styleHint="categorized.xsl">
  <p:prepareDocument/>
  <p:aclInfo/>
  <p:subscriptionInfo/>

  <p:group id="related">
    <p:performQuery>
      <p:query>select name where $Category = ContextDoc($Category) and id != ContextDoc(id)</p:query>
    </p:performQuery>
  </p:group>

</p:publisherRequest>
<wikidata directory>/sites/siteconf.xml
<publisherRequestSet>foobar</publisherRequestSet>
styleHint
categorized.xsl
categorized.xsl
<wikidata directory>/resources/skins/default/document-styling/html/categorized.xsl
<xsl:stylesheet version="1.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:d="http://outerx.org/daisy/1.0"
  xmlns:p="http://outerx.org/daisy/1.0#publisher"> 

  <xsl:import href="daisyskin:xslt/document-to-html.xsl"/>

  <xsl:template match="d:document">
    <h1 class="daisy-document-name"><xsl:value-of select="@name"/></h1>
    <xsl:apply-templates select="d:parts/d:part"/>
    <xsl:apply-templates select="d:links"/>
    <xsl:apply-templates select="d:fields"/>

    <hr/>
    Other documents in this category:
    <ul>
      <xsl:for-each select="../p:group[@id='related']/d:searchResult/d:rows/d:row">
        <li>
          <a href="{$documentBasePath}{@documentId}?branch={@branchId}&amp;language={@languageId}">
            <xsl:value-of select="d:value[1]"/>
          </a>
        </li>
      </xsl:for-each>
    </ul>

    <xsl:call-template name="insertFootnotes">
      <xsl:with-param name="root" select="."/>
    </xsl:call-template>
  </xsl:template>

</xsl:stylesheet>
daisy:docid@branch:language:version#fragmentid
#fragmentid
href
<a>
src
<img>
<span class="crossref">
<a href="daisy:123" p:navigationPath="/info/123">
  <p:linkInfo documentName="..." documentType="...">
    <p:linkPartInfo id="..." name="..." fileName="..."/>
  </p:linkInfo>
  see this
</a>
<a>
<img>
http://outerx.org/daisy/1.0#linktransformer
lt
lt:partLink
lt:fileName
dsy<docid>_
#dsy123_hello
dsy<docid>_
lt:ignore="true"
default
<wikidata directory>/sites/siteconf.xml
default
<siteconf xmlns="http://outerx.org/daisy/1.0#siteconf">
  <skin>default</skin>
</siteconf>
<wikidata directory>/sites/skinconf.xml
<skinconf>
  <logo>resources/local/mylogo.png</logo>
  <daisy-home-link>Daisy Home</daisy-home-link>
  <site-home-link>Site Home</site-home-link>
</skinconf>
logo
<wikidata directory>/resources/local
daisy-home-link
site-home-link
<wikidata directory>/resources/skins
<DAISY_HOME>/daisywiki/webapp/daisy/resources/skins/default
coolskin
<wikidata directory>/resources/skins/coolskin
baseskin.txt
default
coolskin
default
<wikidata directory>/sites/siteconf.xml
<skindir>/css/layout.css
<skindir>/xslt/layout.xsl
<page>
  <!-- The context element is usually produced by the PageContext class
       (but the layout.xsl doesn't care about this of course) -->
  <context>
    <!-- Information about the Daisy Wiki version -->
    <versionInfo version="..." buildHostName="..." buildDateTime="..."/>

    <!-- The mountPoint is everything of the URI path that comes before
         the part matched by the Daisy sitemap. By default, this is /daisy -->
    <mountPoint>...</mountPoint>

    <!-- The current 'version mode' -->
    <versionMode>live|last</versionMode>

    <!-- The site element specifies some information about the current Daisy Wiki site,
         this is of course only required when working in the context of a site. -->
    <site
      name="..."
      title="..."
      description="..."
      navigationDocId="..."
      collectionId="..."
      collection="..."
      branchId="..."
      branch="..."
      languageId="..."
      language="..."/>

    <!-- skinconf: the contents of the skinconf.xml file of the current site,
         or of the global skinconf.xml file in case the current page does is
         outside the context of a site. -->
    <skinconf/>

    <!-- user: information about the current user -->
    <user>
      <name>...</name>
      <login>...</login>
      <id>...</id>
      <activeRoles>
        <role id="..." name="..."/>
        (... multiple role elements ...)
      </activeRoles>
      <updateableByUser>true|false</updateableByUser>
      <availableRoles default="name of default role">
        <role id="..." name="..."/>
      </availableRoles>
    </user>

    <!-- layoutType: the type of layout that the layout.xsl must render.
         Tree possibilities:
            - default: the normal layout, possible with navigation tree,
                       page navigation links, links to other variants, etc.
            - mini: minimalistic layout, which shouldn't put the page content
                    inside a table (this layout is used by the editor screen,
                    and the HTMLArea in IE doesn't work when put inside a table.
            - plain: a layout that doesn't display anything beside the content.
    -->
    <layoutType>default|mini|plain</layoutType>

    <!-- request: some info about the request:
             - uri: the full request URI, including query string
             - method: GET, ...
             - server: scheme + host + port number if not 80
                       to which the HTTP request has been sent
    -->
    <request uri="..." method="..." server="..."/>

    <!-- skin: name of the current skin. Can be useful to use in paths to
         resources (images, css, js, ...) -->
    <skin>...</skin>
  </context>

  <!-- pageTitle: a title for the page, this is what comes inside the html/head/title
       element and thus in the title bar of the users' browser. This element may
       contain mixed content (e.g. i18n tags) so its content must be copied entirely,
       not just the string value. -->
  <pageTitle>...</pageTitle>

  <!-- layout hints (optional element):
        wideLayout: if there is no navigation tree and you want to make use of
                    the maximum available width, specify true.
        needsDojo: if you want dojo to be loaded on a non-cforms page, add this
                   attribute.
  -->
  <layoutHints wideLayout="true" needsDojo="true"/>

<n:navigationTree/>

<!-- ACL evluation information of the navigation tree. Optional, if presen

Value type name	Corresponding Java class
string	java.lang.String
date	java.util.Date
datetime	java.util.Date
long	java.lang.Long
double	java.lang.Double
decimal	java.math.BigDecimal
boolean	java.lang.Boolean
link	org.outerj.daisy.repository.VariantKey

	string	long	double	decimal	date	datetime	boolean
=	X	X	X	X	X	X	X
!=	X	X	X	X	X	X	X
<	X	X	X	X	X	X
>	X	X	X	X	X	X
<=	X	X	X	X	X	X
>=	X	X	X	X	X	X
[NOT] LIKE	X
[NOT] BETWEEN	X	X	X	X	X	X
[NOT] IN	X	X	X	X	X	X
IS [NOT] NULL	X	X	X	X	X	X	X

name	searchable	datatype	version dependent	remarks
id	yes	string	no
namespace	yes	string	no	The namespace part of the document ID
name	yes	string	yes
branch	yes	symbolic	no
branchId	yes	long	no
language	yes	symbolic	no
languageId	yes	long	no
link	yes	link	no	The current document variant as a link. This is useful for comparison with link type fields. For example `$someLinkField = link` to find documents which link to themselves in a certain field, or `$someLinkField = ContextDoc(link)` to find documents which link to the context document.
documentType	yes	symbolic	no
versionId	yes	long	yes	ID of the live version, or if the query option `search_last_version` is specified, of the last version
creationTime	yes	datetime	no
ownerId	yes	long	no
ownerLogin	yes	symbolic	no
ownerName	no	string	no
summary	no	string	no	always of last published version
retired	yes	boolean	no
private	yes	boolean	no
lastModified	yes	datetime	no
lastModifierId	yes	long	no
lastModifierLogin	yes	symbolic	no
lastModifierName	no	string	no
variantLastModified	yes	datetime	no
variantLastModifierId	yes	long	no
variantLastModifierLogin	yes	symbolic	no
variantLastModifierName	yes	string	no
%partTypeName.mimeType	yes	string	yes
%partTypeName.size	yes	long	yes
%partTypeName.content	no	xml	yes	only works for part types for which the flag 'daisy html' is set to true, and additionally the actual part must have the mime type 'text/xml'
versionCreationTime	yes	datetime	yes
versionCreatorId	yes	long	yes
versionCreatorLogin	yes	symbolic	yes
versionCreatorName	yes	string	yes
versionState	yes	symbolic	yes	'draft' or 'publish'
totalSizeOfParts	yes	long	yes	sum of the size of all parts in document
versionStateLastModified	yes	datetime	yes
lockType	yes	symbolic	no	'pessimistic' or 'warn'
lockTimeAcquired	yes	datetime	no
lockDuration	yes	long	no	(in milliseconds)
lockOwnerId	yes	long	no
lockOwnerLogin	yes	symbolic	no
lockOwnerName	no	string	no
collections	yes	symbolic	no	The collections (the names of the collections) the document belongs too. Behaves the same as a multi-value field with respect to applicable search conditions.
collections.valueCount	yes	symbolic	no	The number of collections a document belongs too.
$fieldTypeName	yes		yes	datatype depends on field type
$fieldTypeName.valueCount	yes	long	yes	Useful for multi-value fields. Searching for a value count of 0 does not work, use the "is null" condition instead.
$fieldTypeName.documentId	yes	string	yes	These special field sub-identifiers are only supported on fields of the type "link". For link field types, the $fieldTypeName identifier checks on the document ID, while these identifiers can be used to check on the branch and language.
$fieldTypeName.branch	yes	symbolic	yes
$fieldTypeName.branchId	yes	long	yes
$fieldTypeName.language	yes	symbolic	yes
$fieldTypeName.languageId	yes	long	yes
$fieldTypeName .namespace	yes	string	yes
#customFieldName	yes	string	no
score	no	double	no	The score of a document after doing a full text search. This score ranges from 0-1. When this identifier is used without the FullText() function it will just return 0.

Mime type	Comment
text/plain
text/xml	e.g. the "Daisy HTML" parts
application/xhtml+xml	XHTML documents
application/pdf	PDF files
application/vnd.sun.xml.writer	OpenOffice Writer files
application/msword application/vnd.ms-word	Microsoft Word files
application/mspowerpoint application/vnd.ms-powerpoint	Microsoft Powerpoint files
application/msexcel application/vnd.ms-excel	Microsoft Excel files

Element	Required	Description
title	yes	a (typically short) title for the site
description	yes	a description for the site, shown on the sites overview page
skin	yes	the skin to use for this site
navigationDocId	yes	the ID of the navigation document
homepageDocId	one of these	the ID of the homepage
homepage	one of these	a path to the homepage, used instead of the homepageDocId. Usually this is a path to a Wiki extension (`ext/something`)
collectionId	one of these	the ID of the default collection for the site
collectionName	one of these	the name of the default collection of the site. Will only be used when collectionId is not set.
contextualizedTree	yes	true or false. Indicates whether the navigation tree should be shown in full (= when false), or if the navigation tree should only have open branches leading to the selected node (= when true)
navigationDepth		always displays the first n levels of the navigation tree. When using this with contextualizedTree=true then the first n levels will always be shown no matter what and more may be shown as you progress through the navigation. When using contrextualizedTree=false then only the first n levels will be shown no matter at what place the current document happens to be in the navigation.
branch	no, default main	default branch for the site (specify either the branch ID or name)
language	no, default "default"	default language for the site (specify either the language ID or name)
defaultDocumentType	no	the default document type for this site. The document type can be specified either by ID or by name.
publisherRequestSet	no	which publisher request set to be used for the p:preparedDocuments publisher request for pages rendered in this site.
siteSwitching	no	defines if the browser should be redirected to another site if a document is better suited for display in another site. Valid values for the mode attribute are: stay (never switch to another site), all (consider all available sites as sites to switch to), selected (consider only selected sites, listed in <site> child elements inside the <siteSwitching> element). For more information see URL space management.
newVersionStateDefault	yes	publish or draft. This indicates the default state of the "Publish changes immediately" flag on the edit screen.
locking		the locking strategy to use. To use no locking at all, remove the <automatic> element (but leave the empty <locking> element). To use warn-locking, i.e. only warning that someone else is editing the page but still allowing concurrent edits, change the lockType attribute to "warn".
documentTypeFilter	no	allows to specify a filter for the document types that should be visible when creating a new document within this site. Zero or more include and/or exclude patterns can be specified, the order of the patterns is of no importance. Document types will be shown if they match at least one include pattern and no exclude pattern. If there are only exclude patterns, an implicit `<include name=""/>` is assumed. The patterns can be literal strings, or can contain the wildcards and ?. The wildcard * matches zero or more characters. The wildcard ? matches exactly one character. To match one or more characters, you can use ?. While document type names can't contain these characters, for completes we mention that the wildcards can be escaped using \ and \?, and backslash when used in this context can be escaped using \\ (thus \\* and \\?). Note that this feature is not an access control, it forbids nothing, it just filters the document type list when shown.

name	value	default
include_retired	true/false	false
search_last_version	true/false	false
style_hint	(anything)	(empty)
annotate_link_fields	true/false	true
chunk_offset	an integer (start-index is 1)	N/A
chunk_length	an integer	N/A

Shortcut	Function
ctrl+b	bold
ctrl+i	italic
ctrl+z	undo
ctrl+y	redo
ctrl+c	copy
ctrl+x	cut
ctrl+v	paste
ctrl+1, ctrl+2, ...	switch to header level 1, 2, ...
ctrl+a	select all
ctrl+q	switch between bullets / no bullets
ctrl+r	remove formatting (same as the gum icon) (since Daisy 1.1)

Name
p:aclInfo
p:annotatedDocument
p:annotatedVersionList
p:availableVariants
p:choose
p:comments
p:diff
p:document
p:forEach
p:group
p:ids
p:if
p:myComments
p:navigationTree
p:performFacetedQuery
p:performQuery
p:preparedDocuments (& p:prepareDocument)
p:publisherRequest
p:resolveDocumentIds
p:resolveVariables
p:selectionList
p:shallowAnnotatedVersion
p:subscriptionInfo
p:variablesConfig
p:variablesList

Daisy documentation

Table of Contents

1 Documentation Home

2 Installation

2.1 Downloading Daisy

2.2 Installation Overview

2.2.1 Platform Requirements

2.2.2 Memory Requirements

2.2.3 Required knowledge

2.2.4 Can I use Oracle, PostgreSQL, MS-SQL, ... instead of MySQL? Websphere, Weblogic, Tomcat, ... instead of Jetty?

2.3 Installing a Java Virtual Machine

2.3.1 Installing JAI (Java Advanced Imaging) -- optional

2.4 Installing MySQL

2.4.1 Creating MySQL databases and users

2.5 Extract the Daisy download

2.6 Daisy Repository Server

2.6.1 Initialising and configuring the Daisy Repository

2.6.2 Starting the Daisy Repository Server

2.7 Daisy Wiki

2.7.1 Initializing the Daisy Wiki

2.7.2 Creating a "wikidata" directory

2.7.3 Creating a Daisy Wiki Site

2.7.4 Starting the Daisy Wiki

2.8 Finished!

2.9 2.0(.x) to 2.1 changes

2.10 2.0(.x) to 2.1 compatibility

2.10.1 Skin compatibility

2.10.1.1 XSL-FO (stylesheets for PDF)

2.10.2 Repository extensions, authentication schemes, etc

2.10.2.1 New Runtime

2.10.2.2 Package move

2.10.2.3 AbstractAuthenticationFactory

2.10.3 Publisher wraps exception

2.10.4 Book publisher

2.10.4.1 If you're using custom book publication types

2.10.5 Changes to non-public things

2.10.5.1 Constants.DAISY_LINK_PATTERN

2.10.5.2 Change to htmlcleaner.xml

2.10.6 Automated installation

2.11 2.0(.x) to 2.1. upgrade

2.11.1 Upgrading

2.11.1.1 Daisy installation review

2.11.1.2 Stop your existing Daisy

2.11.1.3 Download and extract Daisy 2.1

2.11.1.4 Update environment variables

2.11.1.5 Creating log configuration

2.11.1.6 Updating the repository SQL database

2.11.1.7 Adjusting the daisy.xconf file

2.11.1.8 ActiveMQ configuration

2.11.1.9 Jetty configuration (only when using a custom jetty-daisywiki.xml)

2.11.1.10 Wrapper scripts

2.11.1.11 Start the servers

2.11.1.12 Update the default repository schema

2.12 2.1-RC to 2.1 upgrade

2.12.1 Changes since 2.1-RC

2.12.2 Upgrade instructions

2.12.2.1 Daisy installation review

2.12.2.2 Stop your existing Daisy

2.12.2.3 Download and extract Daisy 2.1

2.12.2.4 Update environment variables

2.12.2.5 Start Daisy

3 Source Code

3.1 Daisy Build System

3.1.1 Maven intro

3.1.2 Extra dependencies

3.1.3 Building Daisy

4 Repository server

4.1 Documents

4.1.1 Introduction

4.1.2 No hierarchy

4.1.3 Documents & document variants

4.1.4 Document properties

4.1.4.1 ID

4.1.4.2 Owner

4.1.4.3 Created

4.1.4.4 Last Modified and Last Modifier

4.1.5 Document variant properties

4.1.5.1 Versions

4.1.5.2 Versioned Content

4.1.5.2.1 Version ID