Difference between revisions of "Manual"

From EPrints Documentation
Jump to: navigation, search
m (Installation and First Steps)
(Technical Reference)
 
(27 intermediate revisions by 3 users not shown)
Line 4: Line 4:
 
* [[Introduction|Introduction to EPrints]] and [[History|History of EPrints]]  
 
* [[Introduction|Introduction to EPrints]] and [[History|History of EPrints]]  
  
 +
<table cellpadding="10"><tr><td width="33%" valign="top">
 +
= Releases =
 +
{{releasenotes}}
 +
''See also the note on [[EPrints Version Numbering]]''
  
<table cellpadding="10"><tr><td width="33%" valign="top">
 
  
= Installation and First Steps =
+
= Download =
 +
{{Download}}
  
* [[Quick Server Install Guide (Debian / Ubuntu Server)]]
 
  
== Releases ==
+
= Installation =
 
 
{{releasenotes}}
 
* (see also the note on [[EPrints Version Numbering]])
 
 
 
== Download ==
 
{{Download}}
 
 
 
== Installing EPrints ==
 
 
* [[Recommended Platforms]]
 
* [[Recommended Platforms]]
 
* [[Required software]]
 
* [[Required software]]
 
* Install Guides
 
* Install Guides
 
** [[Installing EPrints on RHEL/Fedora/CentOS]]
 
** [[Installing EPrints on RHEL/Fedora/CentOS]]
*** RedHat Enterprise Linux / CentOS 7 and Fedora 25+.
+
*** Primarily RedHat Enterprise Linux (RHEL) and CentOS 7 and 8.
 
*** Guides for installing from RPM package and from source.
 
*** Guides for installing from RPM package and from source.
 
** [[Installing EPrints on Debian/Ubuntu]]
 
** [[Installing EPrints on Debian/Ubuntu]]
*** Debian 7 and 8 and Ubuntu 14.04 LTS and 16.04 LTS.
+
*** Primarily Ubuntu 18.04 LTS and 20.04 LTS.
 
*** Guides for installing from Deb package and from source.
 
*** Guides for installing from Deb package and from source.
** [[Installing EPrints 3 on OS X|Installing EPrints on OS X]] - Not recommended
+
* [[Installation|Generic EPrints installation instructions]]
** [[Installing in a chroot Debian/Ubuntu]]
+
* [[How to use EPrints with HTTPS]]
** [[:Category:Installation|Installing]] EPrints on various platforms.
 
* [[Https3 | Installing EPrints 3 with an https server]]
 
 
** [[Setting up HTTPS using Let's Encrypt]]
 
** [[Setting up HTTPS using Let's Encrypt]]
 +
** [[HTTPS-only and HSTS]]
 +
* [[Installing EPrints using Docker]]
  
 
+
= Post Installation =
Installing EPrints on Ubuntu/Debian
 
==Post Installation==
 
 
* [[Getting Started with EPrints 3]]
 
* [[Getting Started with EPrints 3]]
* [[Upgrading EPrints 3 versions | Upgrading from an earlier version of EPrints3]]
 
* [[Migration|Migrating from EPrints 2.3]]
 
  
==Maintenance==
+
= Maintenance =
 
* [[Backups]]
 
* [[Backups]]
 
* [[Generate Scripts]]
 
* [[Generate Scripts]]
Line 49: Line 40:
 
* [[Automating your maintenance]]
 
* [[Automating your maintenance]]
 
* [[Troubleshooting]]
 
* [[Troubleshooting]]
 +
* [[Apache Hardening]]
 +
</td>
  
== Using EPrints in the Cloud ==
+
<td width="33%" valign="top" style="border-left: solid 1px #ccc; border-right: solid 1px #ccc;">
* [[EPrints EC2]] - Running both a vanilla and training repository!
 
  
== Using the Live CD ==
+
= Training Materials =
* [[EPrints Live CD Help]]
 
* [[Building the Live CD]]
 
 
 
</td><td width="33%" valign="top" style="border-left: solid 1px #ccc; border-right: solid 1px #ccc;">
 
 
 
=Training Materials=
 
 
* [[:Category:Training Video|EPrints Training Course]]
 
* [[:Category:Training Video|EPrints Training Course]]
 
* [http://www.eprints.org/software/training/ Training materials] provided by EPrints Services.
 
* [http://www.eprints.org/software/training/ Training materials] provided by EPrints Services.
 +
  
 
= 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 85: Line 70:
 
* [[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.''
* [[Demoprints Repository]] - ''How to set up and configure the demoprints.eprints.org repository.
+
* [[SWORD]] - ''how to configure the SWORD protocol on EPrints.''
* [[SWORD]] - ''How to configure the SWORD protocol on EPrints.
+
* [[Custom handlers]] - ''how to add a custom handler for intergration with third-party applications.''
* [[:Category:Howto|more ...]]
+
* [[User Deposit Agreement]] - ''How to add a user deposit agreement to the workflow.''
 +
* [[ORCID]]
 +
** [[Import From ORCID]]
 +
* Javascript
 +
** [[Include Javascript in the workflow]]
 +
* DKIM email verification
 +
** [[How to configure DKIM email verification (using sendmail on Rocky9)]]
  
 
= How to contribute =
 
= 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...
 
There's a number of different ways you can contribute to the EPrints project. This section covers all the ones we can think of...
  
Line 103: Line 93:
 
* [[Contribute: Other | Other neighbourly things to do]]
 
* [[Contribute: Other | Other neighbourly things to do]]
 
* [[Extension Packages]]
 
* [[Extension Packages]]
 +
  
 
= Misc =
 
= Misc =
 
 
* [[Preservation Support]] in EPrints 3
 
* [[Preservation Support]] in EPrints 3
 
* [[:Category:Languages|Language support and translations]]
 
* [[:Category:Languages|Language support and translations]]
Line 111: Line 101:
  
 
= Technical Reference =
 
= Technical Reference =
 
+
* [[EPrints Directory Structure]] - How code and configuation files are organised.
* [[EPrints Directory Structure]] - will be linked somewhere better, later.
+
* [[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 138: Line 129:
 
** The [[Request Object]]
 
** The [[Request Object]]
 
* [[:Category:Plugins|Plugins]]
 
* [[:Category:Plugins|Plugins]]
** Import
+
** [[Create Export Plugins|Export]]
** [[Create Export Plugins|Export Plugins]]
+
** Import
** Components
+
** [[Screen Plugins|Screen]]
** [[Screen Plugins]]
 
** Convert
 
 
* [[Autocompletion]]
 
* [[Autocompletion]]
 
** [[Understanding IDs in Workflow Forms]]
 
** [[Understanding IDs in Workflow Forms]]
 
* [[API]]
 
* [[API]]
 
* [[Dynamic Template System]]
 
* [[Dynamic Template System]]
 +
* [[Config Options by File]]
 +
* [[Triggers|Trigger functions]]
  
 
= The EPrints Bazaar =
 
= The EPrints Bazaar =

Latest revision as of 17:26, 25 July 2024

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