...
Make sure the latest Wiki-based Documentation has been exported as HTML and PDF and committed to [dspace-src]/dspace/docs/ in SVN.
| Info |
|---|
| title | Notes about Generating PDF & HTML | How to Generate PDF Documentation |
|---|
|
To generate When generating the PDF document, use the "Scroll Wiki Exporter" option (Tools -> Scroll Wiki Exporter) from the splash page of the Wiki Documentation. - On "Document Information" Tab
- Title: "DSpace Documentation"
- Authors: "DSpace Developers"
| Wiki Markup |
|---|
Version: \[DSpace version number\] |
- On "Formatting" Tab:
- Format: "PDF"
- Theme: "DSpace"
- Make sure to select the checkbox next to all of the following options:
- Create Table of Contents - generates a table of contents page at beginning of PDF
- Ignore
toc macros - ignores all Table of Contents on individual pages - Ignore
children macros - ignores any child page listings on individual pages
- Finally, click the "Export>" button
|
| Info |
|---|
| title | How to Generate HTML Documentation |
|---|
|
To generate the HTML document, just use the normal HTML export: - Go to Browse -> Advanced, Click on "HTML Export"
- Make sure to deselect the "DSpace Documentation" Homepage (top page), as this is not officially part of the DSpace Documentation (it's just a splash page). Instead, select the "DSpace System Documentation" page as the main page (this should also auto-select all other pages below it).
- Make sure to also deselect the "Include comments" option, as they are
. Make sure to select the checkbox next to the following options on the "Formatting Tab": - Ignore
toc macros - ignores all Table of Contents on individual pages - Ignore
children macros - ignores any child page listings on individual pages
When generating to HTML document, just use the normal HTML export (Browse -> Advanced, Click on "HTML Export") option. Make sure to deselect the Homepage (top page), as this is - not officially part of the DSpace Documentation
- Finally, click the "Export" button at the bottom.
- After generating the HTML Documentation, we'll want to do some minor HTML cleanup to make it look nicer.
- Edit go in and edit the 'index.html' page. You'll want to clean up the following text to make it easier to understand:
- Near the top, replace the text "Space Details:" with "DSpace x.y.z Documentation"
- Remove the entire "<table>" at the top of the page which includes last modified & creation info. That table is not as useful outside of a Wiki context.
- Just after the <table>, replace the text "Available Pages:" with "Index:"
- The end result should look something like the HTML version of the DSpace 1.7.0 Documentation
|
| Note |
|---|
| title | Watch for conflicts when updating HTML Documentation in SVN |
|---|
|
It's often easier to completely remove all current HTML content before committing the updated HTML content. Because of the HTML directory structure exported by Confluence, it can be very difficult to determine which files need removing (especially old attachments). So, you may want to completely remove the old HTML directory, before committing the updated content. An example follows: - Delete old HTML docs: e.g.
svn delete http://scm.dspace.org/svn/repo/dspace/trunk/dspace/docs/html (Or delete from branch, as appropriate) - Update your checked-out copy of Trunk/Branch:
svn up | Wiki Markup |
|---|
Locally, recreate the {{\[dspace-source\]/dspace/docs/html/}} in your checked out copy of Trunk/Branch |
| Wiki Markup |
|---|
Copy new HTML docs to {{\[dspace-source\]/dspace/docs/html/}}, so that the {{index.html}} file is at {{html/index.html}} |
- Commit new docs back to SVN
|
...