Dotclear

source: locales/en/help/index.html @ 2535:c582c97d63e0

Revision 2535:c582c97d63e0, 16.9 KB checked in by franck <carnet.franck.paul@…>, 12 years ago (diff)

Update some english helps (antispam filters, main index)

Line 
1<html>
2<head>
3  <title></title> <!-- Leave the title empty -->
4</head>
5
6<body>
7
8<div class="multi-part legible" id="first-step" title="First steps">
9     <h3>Interface discovery</h3>
10     <div class="fieldset">
11          <h4>First steps</h4>
12          <p> In addition to the global help pages, several administration pages have an online help. If javascript is enabled
13          on your browser, you can see online help at the upper-right position of the page, by clicking on the <img src="images/menu/help.png" alt="" /> <strong>Need Help?</strong> link; If Javascript is disabled, the help is displayed at the bottom of the page.</p>
14     </div>
15
16     <p> Each administration page will contain the same top heading, main manu and footer. <em>(The location for each element
17     is shown here for a computer reading; For mobile devices or tablets, the location may vary according the the space available.)</em></p>
18
19     <h4 class="pretty-title">Top heading</h4>
20     <p>The top heading is composed of three elements:</p>
21     <h5 class="as_h4">Logo</h5>
22     <p>By default, this logo is the Dotclear logo, and links to the administration landing page. However, a platform
23     manager can choose another logo, and redirect to something else (generally, the service landing page).</p>
24
25     <h5 class="as_h4">Blog(s)</h5>
26     <p>The first element located after the logo shows the <em>active</em> blog, i.e. the blog on which you are acting. If your
27     installation is composed of several blogs, these information are available in a combo menu, which enables to switch to another blog.</p>
28     <p>The link following the blog name enables to go and see the blog in another window or another tab.</p>
29
30     <h5 class="as_h4">User</h5>
31     <p>At the very right part of the heading section, the link <em>My dashboard</em> enables to get back to the blog landing page.</p>
32     <p>The next link, <em>My preferences</em>, leads to the page where you can modify your personal information, setup the dashboard and choose your interface and editing options.</p>
33     <p>Surprisingly, the link <em>Disconnect [your login]</em> enables to… get disconnected (at Dotclear's, we are ergonomy champions!).</p>
34
35     <h4 class="pretty-title">Main menu</h4>
36     <p>The main menu is located on the left side of the screen. It can be collapsed by clicking on its right border (and then uncollapsed by clicking again on it).</p>
37     <p>It leads to the different administration pages, according to your permissions on the current blog. It is composed of four blocks:</p>
38     <ul>
39          <li><strong>My favorites</strong> lists the pages that you have selected as favorites in the <em>My preferences</em>/<em>My Dashboard</em> tab. If you have not selected any favorite yet, this list will contain the default dotclear set, or the set that has been defined by the platform manager. If you do not want to display this block, you can uncheck the matching checkbox in your dashboard options .</li>
40          <li><strong>Blog</strong> lists all the pages that enable to feed and setup the current blog, from editing an entry, to manage media, or choosing presentation or other parameters.<br />
41          <em>If you do not have admin rights on the current blog, there will not be any other block below that one in the main menu.</em></li>
42          <li><strong>System settings</strong> links to the pages that enable to manage the Dotclear installation : blogs management, users and available languages, plugins installation, system settings. If you have rights on several blogs, but no superadmin rights, you will only see the <em>Blogs</em> entry.</li>
43          <li><strong>Plugins</strong> enables to setup the installed plugins. If the plugin settings only impact one blog at a time, its administration page is available from the <em>Blog</em> block, but if they impact the whole installation, they are located here, and only available for super-admin users.</li>
44     </ul>
45
46     <h4 class="pretty-title">Footer</h4>
47     <p>A free version of Dotclear will be offered to any user who will discover the secret hidden in the footer.</p>
48
49     <h3>Help for great beginners</h3>
50     <p>If you are not familiar with blogs, we recommend that you have a look at our documentation (the whole table of contents is available in the <strong>Documentation</strong> tab of this page) as well as tutorials such as:
51     <ul>
52          <li><a href="http://dotclear.org/documentation/2.0/usage/beginners">My first entry, step by step</a></li>
53     </ul>
54
55     <p>The <a href="http://dotclear.org/forum/">Dotclear forum</a> is a welcoming place where there is no such thing as <em>a stupid question</em>. Don't hesitate to participate if you need help and, why not, to help people in return.</p>
56
57     <p class="info">We try our best to use a vocabulary that is easy to understand without specific knowledge. However, if we end up using a technical term, you will probably find its definition in the <a href="http://dotclear.org/documentation/glossary">glossary</a> of our online documentation.</p>
58</div>
59
60<div class="multi-part" id="users-doc" title="User manual">
61     <h3>User manual</h3>
62     <div class="three-boxes">
63          <h4 class="pretty-title">Managing the content</h4>
64               <ul class="from-left">
65                    <li><a href="http://dotclear.org/documentation/2.0/usage/entries">Entries</a>
66                         <ul>
67                              <li>Creating and editing</li>
68                              <li>Entry details</li>
69                              <li>Entry-related actions</li>
70                              <li>Comments and trackbacks</li>
71                              <li>Batch management of entries</li>
72                         </ul>
73                    </li>
74                    <li><a href="http://dotclear.org/documentation/2.0/usage/comments-trackbacks">Comments and trackbacks</a>
75                         <ul>
76                              <li>Follow-up</li>
77                              <li>Management</li>
78                         </ul>
79                    </li>
80                    <li><a href="http://dotclear.org/documentation/2.0/usage/categories">Categories</a>
81                         <ul>
82                              <li>Creating a category</li>
83                              <li>Editing a category</li>
84                              <li>Deleting a category</li>
85                              <li>Sotring the category list</li>
86                         </ul>
87                    </li>
88                    <li><a href="http://dotclear.org/documentation/2.0/usage/tags">Tags (keywords)</a>
89                         <ul>
90                              <li>Adding tags</li>
91                              <li>Tag management</li>
92                         </ul>
93                    </li>
94                    <li><a href="http://dotclear.org/documentation/2.0/usage/media">Media and attachments</a>
95                         <ul>
96                              <li>Creating a sub-directory</li>
97                              <li>Adding files</li>
98                              <li>Downloading a zip archive of the current directory</li>
99                              <li>Change of gill in file details</li>
100                              <li>Adding files directly</li>
101                              <li>Special file types</li>
102                              <li>Attachments</li>
103                         </ul>
104                    </li>
105                    <li><a href="http://dotclear.org/documentation/2.0/usage/widgets">Blog menu content (widgets)</a>
106                         <ul>
107                              <li>Navigation sidebar, Extra sidebar</li>
108                              <li>Defualt widgets</li>
109                              <li>Adding/removing a widget</li>
110                              <li>Widgets options</li>
111                         </ul>
112                    </li>
113                    <li><a href="http://dotclear.org/documentation/2.0/usage/blogroll">Blogroll</a>
114                         <ul>
115                              <li>Blogroll</li>
116                              <li>Adding a link</li>
117                              <li>Adding a category</li>
118                              <li>XFN</li>
119                              <li>Importing links from an OPML or XBEL file</li>
120                         </ul>
121                    </li>
122               </ul>
123     </div>
124     <div class="three-boxes">
125          <h4 class="pretty-title">Settings and customization</h4>
126               <ul class="from-left">
127                    <li><a href="http://dotclear.org/documentation/2.0/usage/blog-parameters">Blog settings</a>
128                         <ul>
129                              <li>Blog details</li>
130                              <li>Blog configuration</li>
131                              <li>Comments and trackbacks</li>
132                              <li>Blog presentation</li>
133                              <li>Media and images</li>
134                              <li>Search engine robot policy</li>
135                              <li>Antispam</li>
136                              <li>LightBox</li>
137                              <li>Save</li>
138                         </ul>
139                    </li>
140                    <li><a href="http://dotclear.org/documentation/2.0/usage/user-preferences">User preferences</a>
141                         <ul>
142                              <li>My profile</li>
143                              <li>My options</li>
144                              <li>My dashboard</li>
145                         </ul>
146                    </li>
147                    <li><a href="http://dotclear.org/documentation/2.0/admin/themes">Blog appearance</a>
148                         <ul>
149                              <li>Choose a theme</li>
150                              <li>Install a theme</li>
151                              <li>Personnalize a theme</li>
152                              <li>Theme editor</li>
153                         </ul>
154                    </li>
155               </ul>
156     </div>
157     <div class="three-boxes fieldset">
158               <h4 class="smart-title">Additional readings</h4>
159                    <h5>Glossary</h5>
160                    <ul><li><a href="http://dotclear.org/documentation/glossary">All these mysterious words used on the Web and in Dotclear</a></li></ul>
161                    <h5>Input syntaxes</h5>
162                         <ul>
163                              <li><a href="http://dotclear.org/documentation/2.0/usage/syntaxes">Wiki syntax and XHTML equivalent</a></li>
164                              <li><a href="http://dotclear.org/documentation/2.0/usage/syntaxes#to-go-further">To go further</a></li>
165                         </ul>
166                    <h5>Subscription (RSS, Atom...)</h5>
167                         <ul>
168                              <li><a href="http://dotclear.org/documentation/2.0/usage/feeds">What's that?</a></li>
169                              <li><a href="http://dotclear.org/documentation/2.0/usage/feeds#how-do-i-make-it-available-on-my-blog">How do I make it available on my blog?</a></li>
170                              <li><a href="http://dotclear.org/documentation/2.0/usage/feeds#how-do-i-suscribe-to-a-feed">How do I subscribe to a feed?</a></li>
171                              <li><a href="http://dotclear.org/documentation/2.0/usage/feeds#to-go-further">To go further</a></li>
172                         </ul>
173               <h4 class="smart-title">Help</h4>
174                    <ul>
175                         <li><a href="http://dotclear.org/forum">The Dotclear forum</a></li>
176                         <li><a href="http://dotclear.org/documentation/2.0/faq">Frequently Asked Questions</a></li>
177                    </ul>
178     </div>
179</div>
180
181     <div class="multi-part" id="admin-doc" title="Documentation for administrators">
182     <h3>Documentation for administrators</h3>
183          <div class="three-boxes">
184          <h4 class="pretty-title">Installation and update</h4>
185               <ul class="from-left">
186                    <li><a href="http://dotclear.org/documentation/2.0/admin/install">Installation</a>
187                         <ul>
188                              <li>Prerequisites</li>
189                              <li>Automatic installation</li>
190                              <li>Standard installation</li>
191                              <li>Installing using the Wizard</li>
192                              <li>Installing from the config.php file</li>
193                              <li>Completing the installation process</li>
194                              <li>Next steps</li>
195                         </ul>
196                         </li>
197                    <li><a href="http://dotclear.org/documentation/2.0/admin/upgrade">Updating</a>
198                         <ul>
199                              <li>Preparing for the update</li>
200                              <li>Automatic upgrade</li>
201                              <li>Updating the program</li>
202                              <li>Updating the database</li>
203                              <li>Appendix: updating a mercurial copy</li>
204                         </ul>
205                    </li>
206                    <li><a href="http://dotclear.org/documentation/2.0/admin/config">Configuration File (config.php) Parameters</a>
207                         <ul>
208                              <li>Introduction</li>
209                              <li>Parameters</li>
210                              <li>Adding information to the file</li>
211                         </ul>
212                    </li>
213                    <li><a href="http://dotclear.org/documentation/2.0/admin/1-to-2">Upgrading from Dotclear 1.2 to Dotclear 2</a>
214                    </li>
215                    <li><a href="http://dotclear.org/documentation/2.0/admin/migrate">Migrating from another blogging software to Dotclear</a></li>
216                    <li><a href="http://dotclear.org/documentation/2.0/admin/local-install">Local installation</a>
217                         <ul>
218                              <li>Windows</li>
219                              <li>Mac OS X</li>
220                              <li>Linux</li>
221                         </ul>
222                    </li>
223                    <li><a href="http://dotclear.org/documentation/2.0/admin/install/iis">Installing Dotclear with IIS7</a></li>
224               </ul>
225
226               <h5>Hosting Annex</h5>
227               <ul class="from-left">
228                    <li><a href="http://dotclear.org/documentation/2.0/hosting">Hosting</a>
229                    </li>
230               </ul>
231          </div>
232          <div class="three-boxes">
233               <h4 class="pretty-title">Administration</h4>
234               <ul class="from-left">
235                    <li><a href="http://dotclear.org/documentation/2.0/admin/users">Managing users</a>
236                         <ul>
237                              <li>Existing user list</li>
238                              <li>Creating a user</li>
239                              <li>Modifying a user</li>
240                              <li>User permissions</li>
241                         </ul>
242                    </li>
243                    <li><a href="http://dotclear.org/documentation/2.0/admin/clean-install">Clean installation</a>
244                    </li>
245                    <li><a href="http://dotclear.org/documentation/2.0/admin/multiblog">Multiblog Installation</a></li>
246                    <li><a href="http://dotclear.org/documentation/2.0/admin/plugins">Managing plugins</a>
247                         <ul>
248                              <li>Installing a plugin</li>
249                              <li>Configuring plugins</li>
250                              <li>Removing a plugin</li>
251                              <li>Updating a plugin</li>
252                         </ul>
253                    </li>
254                    <li><a href="http://dotclear.org/documentation/2.0/admin/themes/blowup">Blowup, le thème par défaut</a>
255                    </li>
256                    <li><a href="http://dotclear.org/documentation/2.0/admin/themes">Blog Themes</a>
257                         <ul>
258                              <li>Choosing a theme</li>
259                              <li>Installing a theme</li>
260                              <li>Customizing a theme</li>
261                              <li>Theme editor</li>
262                         </ul>
263                    </li>
264                    <li><a href="http://dotclear.org/documentation/2.0/admin/aboutconfig">Advanced configuration</a></li>
265               </ul>
266          </div>
267          <div class="three-boxes">
268               <h4 class="pretty-title">Maintenance</h4>
269               <ul class="from-left">
270                    <li><a href="http://dotclear.org/documentation/2.0/admin/backup">Backup and restore</a>
271                         <ul>
272                              <li>Import/Export</li>
273                              <li>Files</li>
274                              <li>Database</li>
275                         </ul>
276                    </li>
277                    <li><a href="http://dotclear.org/documentation/2.0/admin/antispam">Spam comment filters</a>
278                         <ul>
279                              <li>Filter organization</li>
280                              <li>Filter configuration</li>
281                         </ul>
282                    </li>
283               </ul>
284               <div class="fieldset vertical-separator">
285                    <h4 class="smart-title">Help</h4>
286                    <ul>
287                         <li><a href="http://dotclear.org/forum">The Dotclear forum</a></li>
288                         <li><a href="http://dotclear.org/documentation/2.0/faq#administration">Frequently Asked Questions (Administrators)</a></li>
289                    </ul>
290               </div>
291          </div>
292
293     </div>
294
295     <div class="multi-part" id="guide-dev" title="Developers documentation">
296     <h3>Developer and Designer Resources</h3>
297
298          <div class="three-boxes first-child">
299               <h4 class="pretty-title">Design &amp; Themes</h4>
300               <ul class="from-left">
301                    <li><a href="http://dotclear.org/documentation/2.0/resources/themes">Themes</a>
302                         <ul>
303                              <li>User guide for themes</li>
304                              <li>The template tags</li>
305                              <li>Appendix</li>
306                         </ul>
307                    </li>
308                    <li><a href="http://dotclear.org/documentation/2.0/resources/themes/inheritance">Themes inheritance</a>
309                         <ul>
310                              <li>Principle</li>
311                              <li>Limitations</li>
312                              <li>Set up</li>
313                         </ul>
314                         </li>
315                    <li><a href="http://dotclear.org/documentation/2.0/resources/themes/tags">Template tags</a>
316                         <ul>
317                              <li>Generalities / utilities</li>
318                              <li>Blog</li>
319                              <li>Entries</li>
320                              <li>Entries pagination</li>
321                              <li>Comments</li>
322                              <li>Comment preview</li>
323                              <li>Pings</li>
324                              <li>Attachments</li>
325                              <li>Categories</li>
326                              <li>Tags</li>
327                              <li>Archives</li>
328                              <li>Languages</li>
329                              <li>System</li>
330                              <li>Widgets</li>
331                         </ul>
332                    </li>
333               </ul>
334          </div>
335
336          <div class="three-boxes first-child">
337               <h4 class="pretty-title">Code &amp; Plugins</h4>
338               <ul class="from-left">
339                    <li><a href="http://dotclear.org/documentation/2.0/resources/tpl">Creation of a tpl tag for a plugin or a theme</a>
340                         <ul>
341                              <li>Introduction</li>
342                              <li>Values</li>
343                              <li>Instructions blocks</li>
344                              <li>Demonstration of the template cache influence</li>
345                         </ul>
346                    </li>
347                    <li><a href="http://dotclear.org/documentation/2.0/resources/plugins">Plugins</a>
348                         <ul>
349                              <li>Writing a plugin</li>
350                              <li>Appendix</li>
351                         </ul>
352                    </li>
353                    <li><a href="http://dotclear.org/documentation/2.0/resources/plugins/help">Building the plugin contextual help</a></li>
354                    <li><a href="http://dotclear.org/documentation/2.0/resources/authentication">External authentication</a>
355                         <ul>
356                              <li>Preamble</li>
357                              <li>A new authentication class</li>
358                              <li>Scenario</li>
359                              <li>Application</li>
360                         </ul>
361                    </li>
362                    <li><a href="http://dotclear.org/documentation/2.0/resources/xml-rpc">XML/RPC interface</a></li>
363                    <li><a href="http://dev.dotclear.org/code/2/">API documentation</a></li>
364               </ul>
365          </div>
366
367          <div class="three-boxes">
368               <h4 class="pretty-title">Contribution &amp; Support</h4>
369               <ul class="from-left">
370                    <li><a href="http://dotclear.org/documentation/2.0/resources/contribute">Contribute</a>
371                         <ul>
372                              <li>Edit this documentation</li>
373                              <li>Share your creations</li>
374                              <li>Report bugs or suggest new features</li>
375                              <li>Localization</li>
376                    </ul>
377               </li>
378                    <li><a href="http://hg.dotclear.org/">Dotclear source code repository</a></li>
379                    <li><a href="http://dotclear.org/forum">Dotclear forum</a></li>
380               </ul>
381
382               <div class="fieldset">
383                    <h4 class="smart-title">Conventions</h4>
384                    <ul>
385                         <li><a href="http://dotclear.org/documentation/2.0/resources/coding-standards">Coding standards</a></li>
386                         <li><a href="_charte.php">Administration pages chart</a></li>
387                    </ul>
388               </div>
389          </div>
390     </div>
391     <div class="multi-part legible" id="a11y-ergo" title="Accessibility and ergonomy">
392     <h3>Accessibility and ergonomy</h3>
393     <p>The Dotclear interface fulfills almost all the <a href="http://www.w3.org/TR/WCAG20/">WCAG 2.0</a> criterion; We are working towards making Dotclear compatible with <a href="http://www.w3.org/TR/ATAG20/">ATAG 2.0</a> guidelines.</p>
394     <p>Accessibility and ergonomy are one of our main concern. We regularly run analysis with the help of experts and continuously provide fixes and enhancements.</p>
395     <p>You can help us by opening <a href="http://dev.dotclear.org/2.0/report">tickets</a> or by participating on the <a href="http://dotclear.org/forum/">forum</a>. You can also participate in user testing or join our team!</p>
396     </div>
397
398</body>
399</html>
Note: See TracBrowser for help on using the repository browser.

Sites map