Difference between revisions of "Manual"

From EPrints Documentation
Jump to: navigation, search
(Getting Started)
(Added link to glossary moved links for user and admin menus. Removed plugin types unlikely to be added to.)
 
(89 intermediate revisions by 11 users not shown)
Line 1: Line 1:
 +
__NOTOC__
 
See the [[Main Page]] for other areas of this wiki.
 
See the [[Main Page]] for other areas of this wiki.
__NOTOC__
 
= Introduction =
 
  
* [[Introduction]]
+
* [[Introduction|Introduction to EPrints]] and [[History|History of EPrints]]  
* How to Get Help/Support
+
 
* [[History]]  
+
<table cellpadding="10"><tr><td width="33%" valign="top">
 +
= Releases =
 +
{{releasenotes}}
 +
''See also the note on [[EPrints Version Numbering]]''
 +
 
  
 
= Download =
 
= Download =
 
 
{{Download}}
 
{{Download}}
  
= Installing EPrints From Source =
 
  
 +
= Installation =
 
* [[Recommended Platforms]]
 
* [[Recommended Platforms]]
 
* [[Required software]]
 
* [[Required software]]
 +
* Install Guides
 +
** [[Installing EPrints on RHEL/Fedora/CentOS]]
 +
*** Primarily RedHat Enterprise Linux (RHEL) and CentOS 7 and 8.
 +
*** Guides for installing from RPM package and from source.
 +
** [[Installing EPrints on Debian/Ubuntu]]
 +
*** Primarily Ubuntu 18.04 LTS and 20.04 LTS.
 +
*** Guides for installing from Deb package and from source.
 +
* [[Installation|Generic EPrints installation instructions]]
 +
* [[How to use EPrints with HTTPS]]
 +
** [[Setting up HTTPS using Let's Encrypt]]
 +
** [[HTTPS-only and HSTS]]
 +
* [[Installing EPrints using Docker]]
  
 +
= Post Installation =
 +
* [[Getting Started with EPrints 3]]
  
* [[Installing Eprints 3 on Fedora Core 7]] (also applicable to FC6)
+
= Maintenance =
* [[Installing EPrints 3 on RedHat Enterprise 4]]
+
* [[Backups]]
* [[Installing EPrints 3 on OS X]]
+
* [[Generate Scripts]]
* [[Installing EPrints 3 on Ubuntu 6.10]]
+
* [[Alerts]]
* [[Installing EPrints 3 on Debian]]
+
* [[Log Files]]
* [[Debian from source | Installing EPrints 3 on Debian/Ubuntu - The Quicker Way]]
+
* [[Automating your maintenance]]
 +
* [[Troubleshooting]]
 +
</td>
  
 +
<td width="33%" valign="top" style="border-left: solid 1px #ccc; border-right: solid 1px #ccc;">
  
* [[Https3 | Installing EPrints 3 with an https server]]
+
= Training Materials =
 +
* [[:Category:Training Video|EPrints Training Course]]
 +
* [http://www.eprints.org/software/training/ Training materials] provided by EPrints Services.
  
* [[:Category:Installation|Installing]] EPrints on various platforms.
 
 
=Installing EPrints From Binary=
 
* [[Installing EPrints 3 via Redhat RPM]]
 
* [[Installing EPrints 3 via Fedora RPM]]
 
* [[Installing EPrints 3 via apt (Debian/Ubuntu)]]
 
 
=Post Installation=
 
 
* [[Upgrading EPrints 3 versions | Upgrading from an earlier version of EPrints3]]
 
* [[Migration|Migrating from EPrints 2.3]]
 
 
=Getting Started=
 
* [[Getting Started with EPrints 3|Getting Started]]
 
 
* Maintenance
 
** [[Backups]]
 
** [[Generate Scripts]]
 
** [[Alerts]]
 
** [[Log Files]]
 
** [[Automating your maintenance]]
 
 
* [[Troubleshooting]]
 
  
 
= How-to Guides =
 
= How-to Guides =
 
 
''[http://en.wikipedia.org/wiki/Howto What is a how-to?]
 
''[http://en.wikipedia.org/wiki/Howto What is a how-to?]
  
* Orientation <span style="color: #f94; font-size: 130%">(Start here)</span>
+
* [[:Category:Howto|Orientation/Overview]] <span style="color: #f94; font-size: 130%">(Start here)</span>
** [[Configuration orientation|New to EPrints 3?]]  - ''before diving into the how-tos, take some time to read through this brief orientation guide and familiarise yourself with the EPrints configuration landscape...''
+
** [[Configuration orientation|New to EPrints 3?]]  - ''before diving into the how-tos, take some time to read through this brief orientation guide and familiarise yourself with the EPrints configuration landscape ...''
** [[EPrints_3_Configuration_orientation_for_EPrints_2_administrators|Migrated from EPrints 2?]] - ''this orientation guide is intended to help you re-orient yourselves in your new EPrints 3 set up...''  
 
 
* [[Front Page Warning | Removing the Front Page Warning]] - Your first go at branding
 
* [[Front Page Warning | Removing the Front Page Warning]] - Your first go at branding
 
* [[Branding with confidence]] - ''one of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface...''
 
* [[Branding with confidence]] - ''one of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface...''
Line 73: Line 69:
 
* [[Create Export Plugins]] - ''create a Perl Module that will export your data...''
 
* [[Create Export Plugins]] - ''create a Perl Module that will export your data...''
 
* [[Login-Only Repository]] - ''require a username and password to access all pages (including search, browse, and the front page)...''
 
* [[Login-Only Repository]] - ''require a username and password to access all pages (including search, browse, and the front page)...''
* [[Change Deposit Status in Bulk]] - ''move a large number of deposits from inbox to archive
+
* [[Change Deposit Status in Bulk]] - ''move a large number of deposits from inbox to archive.''
* [[Customisation|more]]
+
* [[SWORD]] - ''how to configure the SWORD protocol on EPrints.''
 +
* [[Custom handlers]] - ''how to add a custom handler for intergration with third-party applications.''
  
= Misc =
+
= How to contribute =
 +
There's a number of different ways you can contribute to the EPrints project. This section covers all the ones we can think of...
 +
 
 +
Always make an entry on http://files.eprints.org/ for your contribution, even if you don't upload the files. This will make it the one-stop place for people to find EPrints extensions.
  
* [[Preservation Support]] in GNU EPrints 3
+
* [[:Category:Documentation Needed| Create some of the missing documentation]]
* [[i18n]]
+
* [[Contribute: Plugins | Plugins]]
* [[How to contribute]]
+
* [[Contribute: Scripts | Scripts]]
** [[Extension Packages]]
+
* [[Contribute: Themes | Themes]]
 +
* [[Contribute: Translations | Translations]]
 +
* [[Contribute: Other | Other neighbourly things to do]]
 +
* [[Extension Packages]]
  
= Technical Reference =
 
  
* [[EPrints Directory Structure]] - will be linked somewhere better, later.
+
= Misc =
 +
* [[Preservation Support]] in EPrints 3
 +
* [[:Category:Languages|Language support and translations]]
 +
</td><td valign="top" width="33%">
  
 +
= Technical Reference =
 +
* [[EPrints Directory Structure]] - How code and configuation files are organised.
 +
* [[EPrints Glossary]] - A listing of terminology used within EPrints.
 +
* [[User Menu]] - Explaining the menu options available to an EPrints user.
 +
* [[Admin|Admin Menu]] - Explaining the tools available to a repository administrator.
 
* [[Metadata]] - configuring metadata fields.
 
* [[Metadata]] - configuring metadata fields.
 
* [[Archives/ARCHIVEID/cfg/|Repository Configuration]]
 
* [[Archives/ARCHIVEID/cfg/|Repository Configuration]]
Line 110: Line 120:
 
** The [[Access Object]]
 
** The [[Access Object]]
 
** The [[Request Object]]
 
** The [[Request Object]]
* Plugins
+
* [[:Category:Plugins|Plugins]]
** Import
+
** [[Create Export Plugins|Export]]
** [[Export Plugins]]
+
** Import
** Components
+
** [[Screen Plugins|Screen]]
** Screen
 
** Convert
 
 
* [[Autocompletion]]
 
* [[Autocompletion]]
 
** [[Understanding IDs in Workflow Forms]]
 
** [[Understanding IDs in Workflow Forms]]
 
* [[API]]
 
* [[API]]
 
* [[Dynamic Template System]]
 
* [[Dynamic Template System]]
 +
 +
= The EPrints Bazaar =
 +
* [[:Category:EPrints_Bazaar|The EPrints Bazaar]] (Start Here)
 +
* The [[EPM Specification]]
 +
* [[:Category:Bazaar_Package|Bazaar Packages]]
 +
 +
</td></tr></table>

Latest revision as of 07:38, 6 March 2022

See the Main Page for other areas of this wiki.

Releases

See also the note on EPrints Version Numbering


Download


Installation

Post Installation

Maintenance

Training Materials


How-to Guides

What is a how-to?

How to contribute

There's a number of different ways you can contribute to the EPrints project. This section covers all the ones we can think of...

Always make an entry on http://files.eprints.org/ for your contribution, even if you don't upload the files. This will make it the one-stop place for people to find EPrints extensions.


Misc

Technical Reference

The EPrints Bazaar