17 |
17 |
18 {% blocktrans %}co-ment is a web based text annotation system.{% endblocktrans %} <a href="http://www.co-ment.org" alt="link to community site">COMT is the open source software behind it</a>. <a href="http://www.co-ment.com" >See www.co-ment.com for more details</a>. |
18 {% blocktrans %}co-ment is a web based text annotation system.{% endblocktrans %} <a href="http://www.co-ment.org" alt="link to community site">COMT is the open source software behind it</a>. <a href="http://www.co-ment.com" >See www.co-ment.com for more details</a>. |
19 |
19 |
20 <h2>{% blocktrans %}Glossary{% endblocktrans %}</h2> |
20 <h2>{% blocktrans %}Glossary{% endblocktrans %}</h2> |
21 |
21 |
22 <h3>{% blocktrans %}Collaboration{% endblocktrans %}</h3> |
22 <h3>{% blocktrans %}Contents{% endblocktrans %}</h3> |
|
23 |
|
24 <a href="#Collaboration">{% blocktrans %}Collaboration{% endblocktrans %}</a><br /> |
|
25 <a href="#Comments">{% blocktrans %}Comments{% endblocktrans %}</a><br /> |
|
26 <a href="#Notifandfeeds">{% blocktrans %}Notification and feeds{% endblocktrans %}</a><br /> |
|
27 <a href="#Roles">{% blocktrans %}Roles{% endblocktrans %}</a><br /> |
|
28 <a href="#Texts">{% blocktrans %}Texts{% endblocktrans %}</a><br /> |
|
29 |
|
30 <a name="Collaboration"></a><h3>{% blocktrans %}Collaboration{% endblocktrans %}</h3> |
23 |
31 |
24 <dl> |
32 <dl> |
25 <dt><a name="collaboration"></a>{% blocktrans %}Collaboration{% endblocktrans %}</dt> |
33 <dt><a name="collaboration"></a>{% blocktrans %}Collaboration{% endblocktrans %}</dt> |
26 <dd>{% blocktrans %}co-ment 2 collaboration is based on assigning roles for users.{% endblocktrans %} <a href="#roles">{% blocktrans %}Click here for more details{% endblocktrans %}</a>. {% blocktrans %}The basic assumption in the collaboration model is that some users will have an overall management role, while others will have roles that are defined in relationship with texts or a given text.{% endblocktrans %} |
34 <dd>{% blocktrans %}co-ment 2 collaboration is based on assigning roles for users.{% endblocktrans %} <a href="#roles">{% blocktrans %}Click here for more details{% endblocktrans %}</a>. {% blocktrans %}The basic assumption in the collaboration model is that some users will have an overall management role, while others will have roles that are defined in relationship with texts or a given text.{% endblocktrans %} |
27 </dl> |
35 </dl> |
28 |
36 |
29 <h3>{% blocktrans %}Comments{% endblocktrans %}</h3> |
37 <a name="Comments"></a><h3>{% blocktrans %}Comments{% endblocktrans %}</h3> |
30 |
38 |
31 <dl> |
39 <dl> |
32 <dt><a name="comment_moderation"></a>{% blocktrans %}Moderation{% endblocktrans %}</dt> |
40 <dt><a name="comment_moderation"></a>{% blocktrans %}Moderation{% endblocktrans %}</dt> |
33 <dd>{% blocktrans %}Comment moderation is the process of editing/removing comments from a text. The moderator role is the collection of permissions required to edit/remove a comment submitted by users of the workspace. |
41 <dd>{% blocktrans %}Comment moderation is the process of editing/removing comments from a text. The moderator role is the collection of permissions required to edit/remove a comment submitted by users of the workspace. |
34 Although this is not the default, you can require comments to be approved before becoming public by unticking the "a posteriori moderation" box in the settings for the text. If you do so, comments from users with an Observer or Commentator role won't be visible to users who do not have moderation permissions before a user (with at least Moderator role) approves them.{% endblocktrans %} |
42 Although this is not the default, you can require comments to be approved before becoming public by unticking the "a posteriori moderation" box in the settings for the text. If you do so, comments from users with an Observer or Commentator role won't be visible to users who do not have moderation permissions before a user (with at least Moderator role) approves them.{% endblocktrans %} |
47 |
55 |
48 <dt><a name="comment_versions"></a>{% blocktrans %}Keeping your comments across versions{% endblocktrans %}</dt> |
56 <dt><a name="comment_versions"></a>{% blocktrans %}Keeping your comments across versions{% endblocktrans %}</dt> |
49 <dd>{% blocktrans %}When you create a new version of the text, comments are duplicated. In case the text edition did not change the scope of the comment, it will be kept "as is". If the text of the comment scope has been modified then a decision has to be made regarding the conservation of such comments in the new version: you'll be given a choice of either keep them in the new version as "detached" from the text (they do not have a scope in the new version's but are still visible when browsing, and you can give them a new scope) or simply removed from the new version.{% endblocktrans %}</dd> |
57 <dd>{% blocktrans %}When you create a new version of the text, comments are duplicated. In case the text edition did not change the scope of the comment, it will be kept "as is". If the text of the comment scope has been modified then a decision has to be made regarding the conservation of such comments in the new version: you'll be given a choice of either keep them in the new version as "detached" from the text (they do not have a scope in the new version's but are still visible when browsing, and you can give them a new scope) or simply removed from the new version.{% endblocktrans %}</dd> |
50 </dl> |
58 </dl> |
51 |
59 |
52 <h3>{% blocktrans %}Notification and feeds{% endblocktrans %}</h3> |
60 <a name="Notifandfeeds"></a><h3>{% blocktrans %}Notification and feeds{% endblocktrans %}</h3> |
53 |
61 |
54 <dl> |
62 <dl> |
55 <dt><a name="email_notifications"></a>{% blocktrans %}Email notification{% endblocktrans %}</dt> |
63 <dt><a name="email_notifications"></a>{% blocktrans %}Email notification{% endblocktrans %}</dt> |
56 <dd>{% blocktrans %}Email notifications are a way for users to be informed by email when a new comment is added on a text or a text is edited and a new version gets created.{% endblocktrans %}</dd> |
64 <dd>{% blocktrans %}Email notifications are a way for users to be informed by email when a new comment is added on a text or a text is edited and a new version gets created.{% endblocktrans %}</dd> |
57 |
65 |
64 <dt><a name="embed"></a>{% blocktrans %}Text embedding{% endblocktrans %}</dt> |
72 <dt><a name="embed"></a>{% blocktrans %}Text embedding{% endblocktrans %}</dt> |
65 <dd>{% blocktrans %}You can embed your text into a page of your own website. Visitors will be able to add comments without leaving your website if the anonymous users' roles on the text allow it. For a proper test condition when embedding in your own site, in particular for experiencing links referencing comments in the same or different text, be sure your are not logged into your workspace in another tab of your browser.{% endblocktrans %}</dd> |
73 <dd>{% blocktrans %}You can embed your text into a page of your own website. Visitors will be able to add comments without leaving your website if the anonymous users' roles on the text allow it. For a proper test condition when embedding in your own site, in particular for experiencing links referencing comments in the same or different text, be sure your are not logged into your workspace in another tab of your browser.{% endblocktrans %}</dd> |
66 |
74 |
67 </dl> |
75 </dl> |
68 |
76 |
69 <h3>{% blocktrans %}Roles{% endblocktrans %}</h3> |
77 <a name="Roles"></a><h3>{% blocktrans %}Roles{% endblocktrans %}</h3> |
70 <dl> |
78 <dl> |
71 <dt><a name="roles"></a>{% blocktrans %}Roles{% endblocktrans %}</dt> |
79 <dt><a name="roles"></a>{% blocktrans %}Roles{% endblocktrans %}</dt> |
72 <dd>{% blocktrans %}Roles are predefined sets of permissions.{% endblocktrans %}</dd> |
80 <dd>{% blocktrans %}Roles are predefined sets of permissions.{% endblocktrans %}</dd> |
73 <dd>{% blocktrans %}A text is visible to the public (non-logged-in visitors, aka anonymous users) only if anonymous users are given a role on the text.{% endblocktrans %}</dd> |
81 <dd>{% blocktrans %}A text is visible to the public (non-logged-in visitors, aka anonymous users) only if anonymous users are given a role on the text.{% endblocktrans %}</dd> |
74 <dt><a name="local_role"></a>{% blocktrans %}Text role{% endblocktrans %}</dt> |
82 <dt><a name="local_role"></a>{% blocktrans %}Text role{% endblocktrans %}</dt> |
75 <dd>{% blocktrans %}A text role is a role that is set for a specific user on a specific text. It can be used to override a possibly existing workspace-level role or to give a user a role on a text (and not on every text in the workspace).{% endblocktrans %}</dd> |
83 <dd>{% blocktrans %}A text role is a role that is set for a specific user on a specific text. It can be used to override a possibly existing workspace-level role or to give a user a role on a text (and not on every text in the workspace).{% endblocktrans %}</dd> |
76 <dt><a name="role_model"></a>{% blocktrans %}Role model{% endblocktrans %}</dt> |
84 <dt><a name="role_model"></a>{% blocktrans %}Role model{% endblocktrans %}</dt> |
77 <dd>{% blocktrans %}A role model is a role set useful in a specific use case. When you set up a co-ment service, you have to select a role model. The default model addresses most cases. A specialized role model such as "teacher" includes specific roles making in this particular case possible for comments to be privately shared between a teacher and each student.{% endblocktrans %}</dd> |
85 <dd>{% blocktrans %}A role model is a role set useful in a specific use case. When you set up a co-ment service, you have to select a role model. The default model addresses most cases. A specialized role model such as "teacher" includes specific roles making in this particular case possible for comments to be privately shared between a teacher and each student.{% endblocktrans %}</dd> |
78 </dl> |
86 </dl> |
79 |
87 |
80 <h3>{% blocktrans %}Text edition{% endblocktrans %}</h3> |
88 <a name="Texts"></a><h3>{% blocktrans %}Texts{% endblocktrans %}</h3> |
|
89 |
|
90 <dl> |
|
91 <dt><a name="create-upload"></a>{% blocktrans %}Create or upload?{% endblocktrans %}</dt> |
|
92 <dd>{% blocktrans %}There are 3 main ways to produce a text in co-ment. If you start from scratch, create your text in markdown format. If you start from an existing file upload it to a markdown format. If you start from a Web page, create a text with HTML as format, and copy and paste the full Web page into the editor.{% endblocktrans %}</dd> |
|
93 </dl> |
81 |
94 |
82 <dl> |
95 <dl> |
83 <dt><a name="format"></a>{% blocktrans %}Text formats{% endblocktrans %}</dt> |
96 <dt><a name="format"></a>{% blocktrans %}Text formats{% endblocktrans %}</dt> |
84 <dd>{% blocktrans %}There are at this date 3 text formats: markdown (default/preferred format), HTML and RST.{% endblocktrans %}</dd> |
97 <dd>{% blocktrans %}There are at this date 3 text formats: markdown (default/preferred format), HTML and RST.{% endblocktrans %}</dd> |
85 </dl> |
98 </dl> |