This application makes heavy use of MarkLogic XSLT to transform content stored in the database into templatized web pages. There is plenty of sample code, but it is not designed, currently, for easy learning purposes.
All original code in this repository is Copyright MarkLogic 2010-2014. All Rights Reserved. It is made available for your use via an Apache 2.0 license (http://www.apache.org/licenses/LICENSE-2.0.html)
Configuration and deployment are managed through Roxy.
You have the option of installing just the Docs application (as seen at http://docs.markklogic.com) or the entire RunDMC application, including Docs (as seen at http://developer.marklogic.com).
- MarkLogic 7.0-4.1 or later
- Ruby 1.9.3+ (for Roxy)
To set up the application, first check whether the default ports work for you. You can see the default ports by viewing deploy/build.properties or by asking Roxy:
$ ./ml local info | grep port
The info command shows you the properties as Roxy sees them.
If you want to change the ports, the admin password, or other properties
for your local environment, do so by creating a deploy/local.properties file.
You can create this file directly, or by setting the login credentials:
$ ./ml local credentials
Once you have a deploy/local.properties file you can edit it as needed.
Copy any properties you wish to change from deploy/build.properties
into deploy/local.properties, and set the values as needed.
Do not check this file in: this file is used for local configuration changes only.
If you change the ports, you will also need to create src/config/server-urls-local.xml. This file is also not to be checked in. You can copy the host/@type="local" example from server-urls.xml. Both files will be loaded (if present), and the -local version will take precedence if present.
In deploy/build.properties, change the modules-root property to point to the location of your project's src directory. Specify the absolute path.
Bootstrapping creates the app servers, databases, forests, users, and roles needed to make the application run. Before you do this, there's one customization step you need to run. RunDMC currently expects to find source code on the file system, rather than in a modules directory. That means you need to tell it where to look. Edit your deploy/local.properties file (create it if necessary) and put in a line like this:
modules-root=/Users/dcassel/Downloads/RunDMC-master/src
Edit to make the path match your filesystem. It needs to be an absolute path. Once you've done that, you can run the bootstrap command:
$ ./ml local bootstrap
You may append "dmc" or "docs" to the command; if you do not, it will prompt you to specify which application it should set up.
Roxy-deployed applications typically use a modules database and deploy code using "./ml local deploy modules", but this application uses the file system.
To use the full RunDMC application, you do need to get some initial files into the content database. This step is not necessary if you are only setting up the Docs application.
$ ./ml local deploy content
The Docs app takes a .zip file containing all documentation for a MarkLogic release as input and puts the contents into the content database.
$ ./ml local deploy_docs
Properties can also be supplied in an environment-specific file
such as local.properties:
build-version=8.0
build-zip-path=/tmp/MarkLogic_8_pubs.zip
build-clean=1
These properties can also be supplied as part of a command.
$ ./ml local deploy_docs --ml.build-zip-path=/tmp/MarkLogic_8_pubs.zip
If the build version or zip path are not defined, you will be prompted to supply them.
If you don't want to rebuild the entire doc set, specific actions can also be supplied via another property. For example this command will rebuild the TOC.
$ ./ml local deploy_docs --ml.build-actions=setup
The available actions are implemented in src/apidoc/setup.xqy.
You may receive an error if you do not have all required Ruby gems installed.
ERROR: The net-http-digest_auth gem is required for this feature.
net-http-digest_auth is required for deploy_docs. To install this gem and proceed:
$ sudo gem install net-http-digest_auth
This project is actually a family of applications.
This is the parent application, as is seen on developer.marklogic.com.
This is the documentation host - like docs.marklogic.com
This app server must have the word "Draft" in its name.
On another port, same exact configuration as main server but with a different server name. "Draft" documents will be visible on this server. For "preview" to work in the Admin UI, update /config/server-urls.xml with the correct host name and corresponding draft server URL. Default is same hostname, port 8004.
This app server must have the word "Admin" in its name. This is used to edit content that will appear on DMC.
If you want "view XML source" to work in the admin UI, set up a WebDAV server with root set to "/". Then add the server URL to /config/server-urls.xml. Default is same hostname, port 8005.
Note: OS X users, you will want to keep OS X from creating .DS_Store files by doing the following
% defaults write com.apple.desktopservices DSDontWriteNetworkStores true
If you want to use the loading tools to copy a database from the live developer site, you'll need an XDBC server.
The four most important code directories are "model", "view", "controller", and "config":
Contains XQuery modules for data access and document filtering.
Contains the XSLT code for rendering the content of the site, including navigational behavior, widget rendering, implementation of the tag library, etc. The stylesheet "page.xsl" is the only top-level stylesheet that gets invoked. It imports or includes everything else.
Contains the URL rewriter and XQuery scripts for handling HTTP requests and for invoking the (XSLT) view code (transform.xqy).
Contains the sitemap configuration, XHTML template configuration, server URL configuration, and widget configuration.
Some documents in the content database drive the application itself.
Contains a complete application for managing XML content via Web forms. Contains its own "model", "view", "controller", and "config" directories.
For more details, see the various README.txt files appearing in sub-directories.