Differences

This shows you the differences between two versions of the page.

--- en:user_advanced:web_editor [2016/06/23 06:52] – [Using the web editor to insert a document into a hierarchy created by a hierarchical classifier] anupama
+++ en:user_advanced:web_editor [2024/06/03 23:51] (current) – [Online Document Editing in Greenstone 3] kjdon
@@ Line 1: / Line 1: @@
-======  Using Greenstone 3's Web Editor ======
-The following instructions are by Georgy Litvinov.
-**Requirements:** a Greenstone3 installation, a collection to test it on.
-. Run the Greenstone 3 server (gs3-server) and visit your digital library home page in the browser. If you have installed Greenstone 3 on your PC, the URL to visit would be ''http://localhost:8383/greenstone3/library'' or ''http://127.0.0.1:8383/greenstone3/library''
-. You need to be logged in to edit your collection. To do so when using the default Greenstone 3 library interface, you'd click the ''Login'' button at the top right of the home page. (For the half-tone interface, click on the down arrow at the bottom of the home page to View More options, and then follow the Login link). Use the username and password you created during installation. The default is admin for both. If you haven't change the defaults, you can do so by running ''ant config-admin'' from the command line.
+======  Online Document Editing in Greenstone 3 ======
-. You need to enable the document edit mode. To do so, click on the button with your account name at the top right of the page (where the Login button was). From the drop-down list, choose ''Enable edit mode''.
+Greenstone 3 allows you to edit the content and metadata of documents online in a web browser. This functionality is available to logged-in users who have been assigned to either the "all-collections-editor" group, or the "collname-collection-editor" group, where collname is the short identifier of the collection (its folder name in the collect folder).
-. Open the document you wish to edit. You can do this by using Search or to locate your document, or you can simply open the document after Browsing to it with a collection classifier.
+You need to be logged in to edit the collection. To do so when using the default Greenstone 3 library interface, you'd click the ''Login'' button at the top right of the home page. (For the half-tone interface, click on the down arrow at the bottom of the home page to View More options, and then follow the Login link).
-. With a document open, click on the ''Edit content'' button to the right.
+You can use the administrator username (admin) and password you created during installation. The default is admin for both. If you haven't change the defaults, you can do so by running ''ant config-admin'' from the command line. Alternatively (and preferably), create your own account (from the Register link on the home page). An admin user will need to assign the correct group to the new username. (See the [[en:user_advanced:gs3_user_management|user management]] page.)
-. You'll now be you able to edit the internal content of your document much like in your favourite text editor. Click on anywhere in the text body of the document to see a cursor to start editing the content.
+Open the document you wish to edit. You can do this by using Search or to locate your document, or you can simply open the document after Browsing to it with a collection classifier.
-. You can modify metadata by pressing ''edit metadata'' button above the document body.
+You need to enable the document edit mode. To do so, click on the button with your account name at the top right of the page (where the Login button was). From the drop-down list, choose ''Enable edit mode''. Note, that if you are not in the right group, 'Enable edit mode' will be be available (3.09 and later).
-. If you want to add new metadata, fill in the field underneath the metadata table with a new metadata name and click on the button ''Add new metadata''. Your new metadata entry will appear at the end of the metadata table. Then enter a value for your new metadata entry.
+With a document open, click on the ''Edit content'' button to the right.
-. If your collection uses a **hierarchy classifier**, you can use the web editor to assign each document to a position in the hierarchy you've already defined in the hierarchy classifier's hfile.
+You'll now be you able to edit the internal content of your document much like in your favourite text editor. Click on anywhere in the text body of the document to see a cursor to start editing the content.
-To add a document to the hierarchy classifier, you need to add a metadata entry just as you did in step 8 above, but with the metadata name set to the ''metadata'' option configured for the hierarchy classifier. For instance, if you built your hierarchy classifier with the metadata option set to dc.Creator, then you'd use the web editor to Add New Metadata with name ''dc.Creator'' for the document.
+You can modify metadata by pressing ''edit metadata'' button above the document body.
-To choose the hierarchy position that you want to assign to your document, click on the value cell for the new metadata field added. To the right of the metadata table, you will then see a flyout menu appear from which you can select the hierarchy position. You can also manually enter the hierarchy position as the metadata value (e.g. ''2.3''). In that case, you will see all the matching suggestions for that hierarchical position from which you can choose. A more detailed example follows below.
+If you want to add new metadata, fill in the field underneath the metadata table with a new metadata name and click on the button ''Add new metadata''. Your new metadata entry will appear at the end of the metadata table. Then enter a value for your new metadata entry.
-. To save your changes, just click on the ''Save and Rebuild'' button and wait for the build to complete.
+To save your changes, just click on the ''Save and Rebuild'' button and wait for the build to complete.
 ==== Using the web editor to insert a document into a hierarchy created by a hierarchical classifier ====
+If your collection uses a **hierarchy classifier**, you can use the web editor to assign each document to a position in the hierarchy you've already defined in the hierarchy classifier's hfile.
+To add a document to the hierarchy classifier, you need to add a metadata entry just as you did  above, but with the metadata name set to the ''metadata'' option configured for the hierarchy classifier. For instance, if you built your hierarchy classifier with the metadata option set to dc.Creator, then you'd use the web editor to Add New Metadata with name ''dc.Creator'' for the document.
+To choose the hierarchy position that you want to assign to your document, click on the value cell for the new metadata field added. To the right of the metadata table, you will then see a flyout menu appear from which you can select the hierarchy position. You can also manually enter the hierarchy position as the metadata value (e.g. ''2.3''). In that case, you will see all the matching suggestions for that hierarchical position from which you can choose. A more detailed example follows below.
 . Let's take the lucene-jdbm-demo collection as an example. Its ''etc/collectionConfig.xml'' file contains the following: