User Tools

Site Tools


wiki:abbi_dokuwiki
LDAP: couldn't connect to LDAP server

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:abbi_dokuwiki [2014/11/10 23:34]
gabriel [Access Control Management]
wiki:abbi_dokuwiki [2014/11/13 17:47] (current)
gabriel
Line 14: Line 14:
   * **N**: No right (permission denied)   * **N**: No right (permission denied)
   * **R**: Only read access   * **R**: Only read access
-  * **E**: Editing +  * **E**: Editing ​existing pages 
-  * **C**: Creating new pages+  * **C**: Creating new namespaces, creating and deleting ​pages
   * **U**: Uploading media (e.g., pictures, document) ​   * **U**: Uploading media (e.g., pictures, document) ​
-  * **D**: Delete+  * **D**: Delete ​pages, namespaces and media
  
 Access rights are ordered (**N**<​**R**<​**E**<​**C**<​**U**<​**D**) such as higher rights include lower rights. Access rights are ordered (**N**<​**R**<​**E**<​**C**<​**U**<​**D**) such as higher rights include lower rights.
  
-Access ​right management is based on user groups and namespaces:​ +In ABBI DokuWiki, access ​right management is based on user groups and namespaces: 
-^ Namespace ​  ​^              User Groups ​                ​^^^^ + 
-^ :::         ​^ @ALL ^ @abbi_ext ^ @abbi_int ^ @abbi_master ^  +^ Namespace ​    ​^              User Groups ​                ​^^^^ 
-^ public ​     |  R   ​| ​ E        |  E        |  D           | +^ :::           ​^ @ALL ^ @abbi_ext ^ @abbi_int ^ @abbi_master ^  
-^ private ​    ​| ​ N   ​| ​ E        |  E        |  D           | +:public     ​| ​ R   ​| ​ E        |  E        |  D           | 
-^ private_iit |  N   ​| ​ N        |  E        |  D           | +:private    |  N   ​| ​ E        |  E        |  D           | 
-^ wiki        |  N   ​| ​ R        |  R        |  E           |+:private_iit|  N   ​| ​ N        |  E        |  D           | 
 +:wiki       ​| ​ N   ​| ​ R        |  R        |  E           |
  
 where the groups are where the groups are
Line 34: Line 35:
   * **@abbi_ext**:​ registered non-IIT ABBI staff   * **@abbi_ext**:​ registered non-IIT ABBI staff
   * **@abbi_int**:​ registered IIT ABBI staff    * **@abbi_int**:​ registered IIT ABBI staff 
-  * **@abbi_master**:​ a selected few who understand what access control ​is about :-). +  * **@abbi_master**:​ a selected few who understand what namespaces and access control ​are about :-).  
 + 
 +There is also a **@abbi_admin** group who can do additional things like moving a page or a namespace, installing a plugin, etc.   
 + 
 +Non-IIT staff must register on the [[https://​accounts.rbcs.iit.it | RBCS portal]]. Contact <​gabriel.baud-bovy@iit.it>​ if you want to change your access rights. 
 + 
 +==== ABBI namespace structure ==== 
 + 
 +A namespace is similar to a directory or folder, while pagenames are similar to files. In DokuWiki you can use [[https://​www.dokuwiki.org/​namespaces | namespaces]] to categorize your [[https://​www.dokuwiki.org/​pagename | pages ]].  
 +  
 +A partial representation of ABBI namespace structure is:  
 + 
 +<​file> ​  
 +   root namespace (always present) 
 +     │ 
 +     ​└── '​public'​ namespace 
 +     ​│ ​      ​└── '​media'​ namespace 
 +     │ 
 +     ​└── '​private'​ namespace 
 +     ​│ ​      ​└── '​media'​ namespace 
 +     ​│ ​      │ 
 +     ​│ ​      ​└── '​ble'​ namespace 
 +     ​│ ​      ​│ ​    ​└── '​media'​ namespace 
 +     ​│ ​      │ 
 +     ​│ ​      ​└── '​fw'​ namespace 
 +     ​│ ​      ​│ ​    ​└── '​media'​ namespace 
 +     ​│ ​      │ 
 +     ​│ ​      ​└── '​hw'​ namespace 
 +     ​│ ​      ​│ ​    ​└── '​media'​ namespace 
 +     ​│ ​      │ 
 +     ​│ ​      ​└── '​app'​ namespace 
 +     ​│ ​            ​└── '​media'​ namespace 
 +     │ 
 +     ​└── '​wiki'​namespace ​                        
 +     │ 
 +     ​└── '​software'​namespace ​                       ​
  
-There is also a **@abbi_admin** group who can do additional things like moving a page or a namespace, installing a plugin, etc.  The namespace **wiki** is reserved for this section of ABBI DokuWiki.+<​\file>​
  
-Non-IIT staff must register on the [[https://rbcscms.humanoids.iit.it/login | RBCS portal]]. Contact <​gabriel.baud-bovy@iit.it>​ if you want to change your access rights.+By convention, namespaces and pagenames in this wiki are in //lower cases// and //​underscores//​ are be used to separate words 
  
-==== Creating ​pages ====+The root namespaces ''​public''​ and ''​private''​ are used to define access rights. By default, child namespaces inherit access rights from their parent namepage and pages inherit access rights from their namepages. Therefore, all pages under the ''​private''​ namespace will have a restricted access as defined previously, etc.
  
-When creating a page in this wiki, the link should ​include a namespace ​to manage its +The ''​media''​ namespace is used to store media (e.g. pictures, videos, documents) that are linked from pages in the corresponding namespace. ​ For example, the picture file ''​pic.jpg''​ inserted in page '':​private:​fw:​overview'' ​should ​be placed in namespace ​'':​private:​fw:media''​. ​
-access rights+
  
-<​code>​ +New pages and namespaces are created by creating a link and editing the page. Exactly where the page is created depends on the syntax of the link:
-   ​[[<​access_namespace>​:<​page_name>​]] +
-</​code>​+
  
-where access is one of the of namespace ​defined above. For example, to create ​page  +  * Absolute paths in links start with a colon '':''​ or with the namespace 
-visible by all, the link should be %%[[:​public:​page]]%%.+  * Relative paths start with colon ''​.''​
  
-By convention in this wikipage names are in lower cases and underscores are +For examplelet's assume ​that one creates ​the following links in the page ''​:private:development''​
-be used to separate words. ​ Note that the whole string is the actual +
-name of the page. Therefore, %%public:page%% is a different page than %%public:page%%. ​+
  
-By default, child pages inherit access rights from their parent page. Creating a ling %%[[new_page]]%% ​in page %%private:page%% actually creates page %%[[private:​new_page]]%%+  - ''​%%[[new_page]]%%''​  
 +  - ''​%%[[:private:new_page]]%%''​ 
 +  - ''​%%[[.ff:​new_page]]%%''​ 
 +  - ''​%%[[:​private:ff:​new_page]]%%''​ 
 +  - ''​%%[[ff:​new_page]]%%''​ 
 +  - ''​%%[[:​ff:​new_page]]%%''​
  
-==== Uploading media ====+  * 1. is relative to the current namespace and will therefore create the page '':​private:​new_page''​ like 2. 
 +  * 3. starts with a colon is is therefore relative to the current namespace and create the page '':​private:​ff:​new_page''​ like 4.  In addition, it will create the namespace ''​ff''​ beneath ''​private''​ if it does not exist. ​  
 +  * Somewhat counter-intuitively,​ the syntax of 5. refers to an absolute path. It will therefore create page '':​ff:​new_page''​ like 6. In addition, it will create '​ff'​ in the root directory if it does not exist. ​
  
-Media should be loaded with double ​namespace ​classification scheme:+[[https://​svn.rbcs.iit.it/​abbi | ABBI SVN]] should ​normally ​be used to manage the development of software within the project. However, it might occasionally be useful to upload in the wiki some software to be distributed (e.g. as zipfile). Software should be placed in the ''​software'' ​namespace. Access right will be managed on a case-by-case basis. ​
  
-  [[:<​access_namespace>:<​type_namespace>:<​filename>​]] 
  
-where access names space are one of the namespace define above and 
-type namespace can be 
  
-  * **doc**: documents (e.g. pdf, docx) 
-  * **pic**: pictures 
-  * **vid**: videos 
  
  
wiki/abbi_dokuwiki.1415658866.txt.gz · Last modified: 2014/11/10 23:34 by gabriel