[[PageOutline]] = Documentation for Web admin interface = Package: '''debserver-common''' == Password change == ''(change my password)'' Available to all users. Here they can change their password. == Dictionaries == Dictionary files and features definition. code:: short dictionary code, used as a dictionary identification name:: dictionary name, displayed to users file:: name of dbxml file class:: Ruby class used for dictionary API, list is fixed and contains all possible classes. File containing class definition must be included in runner script. ''Dictionary'' class is the most common. root tag:: root element of each entry key:: XPath of each entry key indexes:: List of indexed elements/attributes, pairs of element name (attributes name without @) and index type (choose the right type, or the wrong index may cause performance issues). For Wordnet dictionaries, basic set of indexes is filled automatically. xslt:: List of XSLT templates for entries preview, pairs of template name (used in code) and XSLT filename. For Wordnet dictionaries, basic set of templates is filled automatically. packages:: ''(for Wordnet and Cornetto dictionaries)'' list of client packages, pairs of package code (used for identification) and package name (displayed to users). At the moment, only one package is used, but it's possible to have two different packages displaying data in different form for one dictionary. Usually, package code is the same as dictionary code with number 1. eq tags:: ''(for Wordnet and Cornetto dictionaries)'' List of equivalence tags relations to do lookup in other dictionary. Path of element used for relation (same syntax as for WN queries) and dictionary package code. lookup dict:: ''(for Wordnet and Cornetto dictionaries)'' List of dictionary packages to allow (auto)lookup to. List of package codes, separated by comma (,). reload dict:: ''(for Wordnet and Cornetto dictionaries)'' List of dictionaries to reload in client after entry edit. List of dictionary codes, separated by comma (,). Dictionary itself is always included. === Example === * code = wnen * name = English Wordnet * file = wnen.dbxml * class = !WordNet * root tag = SYNSET, cid * key = /SYNSET/ID, /cid/@cid_id * indexes = ID:node-element-equality-string, LITERAL:node-element-substring-string * xslt = xml:xmlpretty.xsl (for neat XML preview), preview:wn-preview.xslt, vb:wnvb.xslt * packages = wneng1:English WN * eq tags = cid.@d_sy_id:cdbsyn1, cid.@c_lu_id:cdblu1 * lookup dict = wncze1,wngre1,wnfre1 * reload dict = wncz == Services == Service is one DEB server running on separate port. Several services can use the same dictionaries. code:: short service code, used as an identification. This code is also used in start script, for example in ''bin/wordnet_services.rb'': {{{ wninfo = WordNetAdmin.new(db_path, 'admininfo.dbxml', '', env) wninfo.service_name = 'debvisdic' }}} name:: service name dictionaries:: check the box for dictionaries that should be part of this service == Users == List of server users, each of them may have access to different services and dictionaries. login:: user login name:: real name organization:: user organization address:: user address email:: user email, account information (creation, removal, password reminder) are mailed to this address comment:: any comment about the user password:: If you fill in this field, password is set to entered value (when creating or editing user entry). If left empty while creating new user, password is generated randomly and mail to the user. admin checkbox:: If checked, user has access to admin interface. services + dictionaries:: If you check the box next to the service name, user is given access to this service. But this may not give user access to the dictionary data, as each service may deal with user access rights differently. If service don't require detailed access rights, checking the box is enough. But if more detailed access rights are used, you must fill in access rights to the textboxes next to each dictionary code. Usually, it's 'r' for reading the data and 'w' for read+write access. new pass:: After clicking on this link, new random password is generated for the user and mailed to specified email address. == Sequences == Definition of ID sequences for each dictionary. You can set pattern and number for each dictionary. Whenever a new entry is created, number is raised by 1 and new ID is created by substituting [id] in pattern with new number. For example: for ''cdb_syn'' dictionary, the pattern is '''c_[id]''' and if a new number is 29, then new ID is c_29