All Versions
- DSpace 7.x (Current Release)
- DSpace 8.x (Unreleased)
- DSpace 6.x (EOL)
- DSpace 5.x (EOL)
- More Versions...
Page History
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Documentation Wiki Spaces Overview
Starting with
...
1.7.x,
...
each
...
major
...
version
...
of
...
DSpace
...
has
...
its
...
own
...
Wiki
...
Space.
...
- Space ID:
...
- Each
...
- DSpace
...
- Documentation
...
- space
...
- has
...
- a
...
- "Space
...
- ID"
...
- of
...
- the
...
- following
...
- format:
...
- "DSDOCxx"
...
- (where
...
- 'xx'
...
- represents
...
- the
...
- version
...
- of
...
- DSpace)
...
- (e.g.)
...
- 1.7.x
...
- docs
...
- are
...
- in
...
...
- ,
...
- 1.8.x
...
- docs
...
- are
...
- in
...
- DSDOC18
- For 3.x,
...
- the
...
- docs
...
- are
...
- in
...
- General Space:
...
- The
...
...
- (generic)
...
- space
...
- is
...
- used
...
- to
...
- inform
...
- people
...
- of
...
- all
...
- available
...
- DSpace
...
- Documentation,
...
- e.g.
...
...
...
- ,
...
- as
...
- well
...
- as
...
- provide
...
- a
...
- central
...
- place
...
- for
...
- these
...
- internal
...
- Documentation
...
- Management
...
- notes.
...
- Space
...
- Header:
...
- Each
...
- DSpace
...
- Documentation
...
- space
...
- also
...
- has
...
- a
...
- header
...
- (see
...
...
...
...
- below)
...
- which
...
- lets
...
- users
...
- know
...
- if
...
- it
...
- refers
...
- to
...
- an
...
- old,
...
- current
...
- or
...
- unreleased
...
- version
...
- of
...
- the
...
- software.
...
- Shared
...
- Left
...
- Sidebar:
...
- The
...
- Left
...
- Sidebar
...
- on
...
- all
...
- Documentation
...
- Spaces
...
- is
...
- identical
...
- – it
...
- just
...
- loads
...
- the
...
...
- reusable
...
- content
...
- page.
...
- This
...
- is
...
- very
...
- powerful
...
- as
...
- it
...
- means
...
- that
...
- the
...
- sidebar
...
- on
...
- all
...
- existing
...
- Spaces
...
- can
...
- be
...
- edited
...
- from
...
- a
...
- single
...
- location.
...
- Note:
...
- If
...
- you
...
- view
...
- the
...
- Wiki
...
- source,
...
- you'll
...
- notice
...
- that
...
- the
...
...
- actually
...
- assigns
...
- CSS
...
- classes
...
- to
...
- each
...
- Documentation
...
- link
...
- in
...
- the
...
- "All
...
- Documentation"
...
- list.
...
- This
...
- is
...
- so
...
- that
...
- each
...
- Documentation
...
- Space
...
- can
...
- have
...
- a
...
- custom
...
- CSS
...
- style
...
- which
...
- makes
...
- its
...
- listing
...
- appear
...
- bold
...
- when
...
- you
...
- are
...
- in
...
- that
...
- Space.
...
- For
...
- an
...
- example,
...
- see
...
- the
...
...
- ,
...
- and
...
- DSDOC18 spaces – notice how different items in that listing are bolded. This is a custom CSS style enabled for each Space.
Copying Existing Docs to a New Space
In order to prepare for the next release, you obviously need to begin Unreleased Documentation early. The easiest way to do this is to generate a new Documentation Space for that unreleased version, and copy the latest Documentation over to that space. Luckily, the "Copy Partial Space" plugin for Confluence makes this relatively easy to do.
Here's the steps:
- First, you need to login as an Administrative user and visit the homepage of the latest Documentation (e.g. DSDOC17)
- Under the "Tools" side-menu, select the "Copy into New Space" option (should be at the bottom)
- Select a new Space Name and Space Key (ID) for this brand new space. Make sure to follow our recommended Space ID naming conventions as described above.
- Space Name Format: "DSpace #.x Documentation" (e.g. "DSpace 3.x Documentation")
- Space Key (ID) format: "DSDOC#x" (e.g. DSDOC3x for 3.x Documentation)
- Once the new Space has been generated, visit the new Space. You'll need to change the main page name to match the new version number (e.g. "DSpace 3.x Documentation").
- Next you'll need to tweak several Space settings to get it formatted similar to the rest of our Documentation. We'll start simple by tweaking the "Space Description"
- Go to "Browse -> Space Admin" and change the "Space Description" to have the correct version number (e.g. "Official docs for DSpace 3.x") and click "Save".
- Now, change the "Documentation Space Header" so that we have the "Unreleased Documentation Header" in place. The full instructions can be found below in the #Documentation Space Headers section.
- Now, change the Left Sidebar to load up the _DocLeftSidebar shared content (this displays the DSpace logo and list of recent versions). The full instructions can be found below in the #Documentation Shared Sidebar section.
Documentation Space Headers
As mentioned above, on each Documentation Space we want to provide users with context information to let them know whether the Documentation they are looking at is current, and also give them information on how to get to current or older documentation (based on the version of DSpace they are using).
Editing Headers:
- Space Headers can be edited only by a Wiki Space Administrator
- Visit "Browse -> Space Admin"
- Click on "Themes" (Under "Look and Feel" section)
- Click on "Configure Theme" (for the current Documentation Theme)
- You'll see a "Header" field that you can fill out and click "Save"
There are three types of headers we use on Documentation spaces.
Current Documentation Header
This header is used to notify users that the Documentation Space they are visiting is for the current version of DSpace:
What it looks like:
| Tip | ||
|---|---|---|
| ||
This documentation covers the latest release of DSpace, version 1.8.0. Looking for another version? See all documentation. |
Wiki Source:
| Code Block |
|---|
:] spaces -- notice how different items in that listing are bolded. This is a custom CSS style enabled for each Space. h2. Copying Existing Docs to a New Space In order to prepare for the next release, you obviously need to begin Unreleased Documentation early. The easiest way to do this is to generate a new Documentation Space for that unreleased version, and copy the latest Documentation over to that space. Luckily, the ["Copy Partial Space" plugin|https://studio.plugins.atlassian.com/wiki/display/CCPSP/Home] for Confluence makes this relatively easy to do. Here's the steps: # First, you need to login as an Administrative user and visit the homepage of the latest Documentation (e.g. [DSDOC17|DSDOC17:]) # Under the "Tools" side-menu, select the "Copy into New Space" option (should be at the bottom) # Select a new Space Name and Space Key (ID) for this brand new space. *Make sure to follow our recommended Space ID naming conventions as [described above|#Documentation Wiki Spaces Overview].* #* Space Name Format: "DSpace #.x Documentation" (e.g. "DSpace 3.x Documentation") #* Space Key (ID) format: "DSDOC#x" (e.g. DSDOC3x for 3.x Documentation) # Once the new Space has been generated, visit the new Space. You'll need to change the main page name to match the new version number (e.g. "DSpace 3.x Documentation"). # Next you'll need to tweak several Space settings to get it formatted similar to the rest of our Documentation. We'll start simple by tweaking the "Space Description" #* Go to "Browse -> Space Admin" and change the "Space Description" to have the correct version number (e.g. "Official docs for DSpace 3.x") and click "Save". # Now, change the "Documentation Space Header" so that we have the "Unreleased Documentation Header" in place. The full instructions can be found below in the [#Documentation Space Headers] section. # Now, change the Left Sidebar to load up the [DSDOC:_DocLeftSidebar] shared content (this displays the DSpace logo and list of recent versions). The full instructions can be found below in the [#Documentation Shared Sidebar] section. h2. Documentation Space Headers As mentioned above, on each Documentation Space we want to provide users with context information to let them know whether the Documentation they are looking at is current, and also give them information on how to get to current or older documentation (based on the version of DSpace they are using). *Editing Headers:* * Space Headers can be edited only by a Wiki Space Administrator * Visit "Browse -> Space Admin" * Click on "Themes" (Under "Look and Feel" section) * Click on "Configure Theme" (for the current Documentation Theme) * You'll see a "Header" field that you can fill out and click "Save" There are three types of headers we use on Documentation spaces. h3. Current Documentation Header This header is used to notify users that the Documentation Space they are visiting is for the current version of DSpace: *What it looks like:* {tip:title=Current Release} This documentation covers the latest release of DSpace, version 1.8.0. Looking for another version? [See all documentation|DSDOC:All Documentation]. {tip} *Wiki Source:* {code}{tip:title=Current Release} This documentation covers the latest release of DSpace, version 1.8.0. Looking for another version? [See all documentation|DSDOC:All Documentation]. {tip}{code} h3. Old Documentation Header This header is used to notify users that they are looking at an old version of the Documentation. *What it looks like:* {note:title=Old Release} |
Old Documentation Header
This header is used to notify users that they are looking at an old version of the Documentation.
What it looks like:
| Note | |||
|---|---|---|---|
| |||
|
Wiki Source:
| Code Block |
|---|
}{note:title=Old Release} This documentation relates to an old version of DSpace. {spacejump:DSDOC18|alias=View this same page in the current documentation} (if it exists). Looking for another version? [See all documentation|DSDOC:All Documentation]. {note}{code} h3. Unreleased Documentation Header This header is used to notify users that they are currently viewing documentation for an *unreleased* version of DSpace. *What it looks like:* {warning:title=Unreleased Documentation} |
Unreleased Documentation Header
This header is used to notify users that they are currently viewing documentation for an unreleased version of DSpace.
What it looks like:
| Warning | |||
|---|---|---|---|
| |||
|
Wiki Source:
| Code Block |
|---|
}{warning:title=Unreleased Documentation} This documentation is unreleased and still in development. *It may describe features which are not yet released in DSpace.* \\ {spacejump:DSDOC18|alias=View this same page in the current documentation} (if it exists). Looking for another version? [See all documentation|DSDOC:All Documentation] {warning}{code} h2. Documentation Shared Sidebar As mentioned above, on each Documentation Space we want to have a shared left sidebar which keeps all our Documentation looking similar in nature and allows users to more easily jump between versions of the Documentation. This shared left sidebar is actually a very simple Wiki page (see [DSDOC:_DocLeftSidebar]), which we load into the "navigation" section of each of the Documentation spaces. *Editing The Left Sidebar:* * The left sidebar can be edited only by a Wiki Space Administrator * Visit "Browse -> Space Admin" * Click on "Themes" (Under "Look and Feel" section) * Click on "Configure Theme" (for the current Documentation Theme) * In the "Navigation" field, you want to place the following Wiki Markup (which will cause the [DSDOC:_DocLeftSidebar] wiki page to appear as the sidebar): {code} |
Documentation Shared Sidebar
As mentioned above, on each Documentation Space we want to have a shared left sidebar which keeps all our Documentation looking similar in nature and allows users to more easily jump between versions of the Documentation. This shared left sidebar is actually a very simple Wiki page (see _DocLeftSidebar), which we load into the "navigation" section of each of the Documentation spaces.
Editing The Left Sidebar:
- The left sidebar can be edited only by a Wiki Space Administrator
- Visit "Browse -> Space Admin"
- Click on "Themes" (Under "Look and Feel" section)
- Click on "Configure Theme" (for the current Documentation Theme)
- In the "Navigation" field, you want to place the following Wiki Markup (which will cause the _DocLeftSidebar wiki page to appear as the sidebar):
Code Block {include:DSDOC:_DocLeftSidebar}
...
- Click "Save"
...
- Now,
...
- we'll
...
- likely
...
- want
...
- to
...
- ensure
...
- this
...
- version
...
- of
...
- DSpace
...
- is
...
- listed
...
- in
...
- the
...
- Sidebar.
...
- To
...
- do
...
- that,
...
- just
...
- visit
...
- the
...
...
- page,
...
- edit
...
- it,
...
- and
...
- add
...
- a
...
- line
...
- similar
...
- to
...
- the
...
- following:
...
Code Block
...
{span:class=DSDOC3x}[DSpace 3.x (Unreleased)|DSDOC3x:]{span}
...
- NOTICE THE "{span}"
...
- wiki
...
- tag
...
- listed
...
- there.
...
- That
...
- is
...
- applying
...
- a
...
- custom
...
- CSS style
...
- we named "DSDOC3x". We will tweak that style momentarily.
- Finally, let's
...
- tweak
...
- the
...
- stylesheet
...
- of
...
- the
...
- Space,
...
- so
...
- that
...
- its
...
- listing
...
- in
...
- the
...
- sidebar
...
- appears
...
- bolded
...
- .
...
- Go
...
- back
...
- to
...
- the
...
- "Browse
...
- ->
...
- Space
...
- Admin"
...
- Click
...
- on
...
- "Stylesheet"
...
- (Under
...
- "Look
...
- and
...
- Feel"
...
- section)
...
- Click
...
- "Edit"
...
- and
...
- add
...
- a
...
- style
...
- similar
...
- to
...
- the
...
- following
...
- (notice
...
- that
...
- this
...
- "span"
...
- style
...
- matches
...
- the
...
- "space:class"
...
- defined
...
- above):
...
Code Block
...
/** Bold sidebar link to this Space **/ span.DSDOC3x { font-weight:bold; }
...
- Click Save
The final result is that, when you go back to the Space, you'll see that the contents of the _DocLeftSidebar wiki page now appear in the left sidebar. You'll also notice that this Space's name should appear bolded, and when you click on different versions of the Documentation those Space names should appear bolded instead. This allows the sidebar to always be identical across all Documentation Spaces, which makes it easier to manage across all our documentation.
Reusable Content
Reusable content can be found on the ReusableContent child page.
Overview
Content Tools