Subversion Repositories Sites.tela-botanica.org

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
4 david 1
<erreur_MySQL>
2
 
3
{{{A template problem}}}
4
 
5
When SPIP faces an error in its communication with MySQL database, it displays on the screen the failed query as well as the error message returned by the database (in red).
6
 
7
The problem could result:
8
- either from an error in the definition of your template, if you are in the process of modifying your site;
9
- or from a failure in the database.
10
 
11
For instance, a message of the sort <font color='red'><b>
12
_ <code>> Unknown column 'articles.chapi' in 'where clause'</code></b></font> indicates that the loop calls a selection criteria (<code>chapi</code>) which is not accounted for.
13
 
14
On the other hand, a message of the sort <font color='red'><b>
15
_ <code>> Can't open file: 'spip_articles.MYD'</code></b></font> indicates a serious problem in the MySQL database itself : you should then, ask your host to verify his installation and/or repair your database. If you have a recent version of MySQL (3.23.14 at least), you can also try <a href="admin_repair.php3" target="_blank">an automatic repair of the database</a>.
16
 
17
 
18
</erreur_mysql>
19
 
20
<ftp_auth>
21
 
22
{{{Authentication by FTP}}}
23
 
24
Some of SPIP's functionalities have a direct influence on the structure and the content itself of the database (particularly: updates, backup and restoration of the database...). For these very sensitive features, an FTP authentication procedure has been put in place, in order to restrict their use to the few users who have access to the site server by FTP (more generally, if a site admits several SPIP administrators, FTP access is restricted to the main webmaster).
25
 
26
To be able to use these features, you have to simultaneously:
27
 
28
<UL><LI>connect to the web with your usual browser; when you launch the action, SPIP specifies a name of the format &laquo;admin_{xxxxx}&raquo;, that you must write down;</LI>
29
 
30
<LI>connect to your site's server by FTP; in the folder <TT>/ecrire/data</TT>, create a file (or an empty directory) and name it &laquo;admin_{xxxxx}&raquo;;</LI>
31
 
32
<LI>Once you have created this file or directory, go back to your web browser and reload the page, which concludes the FTP authentication and triggers the action. </LI>
33
 
34
</UL>
35
 
36
</ftp_auth>
37
 
38
<artauteurs>
39
 
40
{{{Authors}}}
41
 
42
When an administrator or an editor creates an article, he is considered automatically the author of the article. In several cases the authors should be changed (i.e. when a third party story is added to the site, when a story shouldn't be signed, or when it is edited by several users...)
43
 
44
- {{Adding an author}}
45
 
46
A drop-down menu showing the list of all the site editors allows selecting and adding a new author.
47
 
48
{If more than 50 editors contribute to the site, it becomes awkward to display them in a drop-down menu (it slows the loading dramatically); in this case, the drop-down menu is replaced by a search box: you enter the name of the author you wish to add and click on &laquo;search&raquo;. If the search returns more than one author, the system will let you select the one you want.}
49
 
50
- {{Removing an author}}
51
 
52
Next to each author of the article, the link &laquo;Remove the author&raquo; allows you to simply remove this author.
53
 
54
{It is only as the author of this particular article that the editor is removed; he obviously remains present in the list of the site editors.}
55
 
56
- {{Replacing an author by another}}
57
 
58
This can be achieved in two steps: simply add the new author and remove the first one (see above).
59
 
60
- It must be stressed finally that the administrators have more power over this authors list than the editors. Particularly, the editors cannot remove themselves from an article. If an editor wishes to publish an anonymous article (without author), he must ask an administrator to perform the operation.
61
 
62
</artauteurs>
63
 
64
<artchap>
65
 
66
{{{The deck}}}
67
 
68
In the publishing jargon, the {deck} is the short text (cap) that &laquo;covers&raquo; the article. It is optional.
69
 
70
Administrators can, via the page &laquo;<A HREF="aide_index.php3?aide=confart" TARGET="_top">Precise configuration </A>&raquo;, disable completely the use of the deck.
71
 
72
</artchap>
73
 
74
<artvirt>
75
 
76
{{{Article redirection}}}
77
 
78
This option allows you to create a &laquo;Virtual Article&raquo;: it is an article which has its title, date and authors recorded in your site under SPIP, but which points to another URL.
79
 
80
This feature enables you to reference in your SPIP system articles that were not created by SPIP (for instance, if you need to integrate to the navigation of your site under SPIP, pages created prior to the installation of SPIP).
81
 
82
To signal that your article is a &laquo;Virtual Article&raquo;, you just have to enter the URL of the target article in the corresponding box.
83
 
84
To remove the redirection, you simply &laquo;empty&raquo; the redirection box (delete the URL of the target article).
85
 
86
</artvirt>
87
 
88
<artdate>
89
 
90
{{{Date of online publishing}}}
91
 
92
Generally, the article's {date} corresponds to the date of its {online appearance} (or publication on the web site).
93
 
94
- This date is automatically set to the time of the article's {validation} by an administrator (therefore, to the time of its appearance on the public site).
95
 
96
- However, after validating the article, the administrator can still modify this date.
97
 
98
</artdate>
99
 
100
<artdate_redac>
101
 
102
{{{Date of earlier publication}}}
103
 
104
This feature was added for very specific cases, where SPIP is used to install archives {and} where these archives must have a publication date different from the online date.
105
 
106
It is a case of being able to indicate that a document has already been the subject of an earlier publication: newspaper article, book...
107
 
108
- by default , this date is not displayed: the option &laquo;Hide date of earlier publication&raquo; is selected at the time of the creation of the article.
109
 
110
- If you want to specify such a date, you must select the option &laquo;Show date of earlier publication&raquo; as well as use the drop-down menus to set it up.
111
 
112
Unlike the &laquo;publication date&raquo; of the article, this date is not automatically determined at the time of the validation of the article. That is why it can be modified at any time.
113
 
114
{The site administrators can disable the use of the earlier publication date in the &laquo;<A
115
HREF="aide_index.php3?aide=confart" TARGET="_top">precise Configuration</A>&raquo; section.}
116
 
117
</artdate_redac>
118
 
119
<artdesc>
120
 
121
{{{Brief description}}}
122
 
123
The {brief description} is used for the purpose of navigating in the site: it shows briefly the topic of the article, in the contents page for instance.
124
 
125
This description is optional; furthermore it can be of any length. However, it was originally meant for short texts (one or two sentences), which will show in the lists of articles (contents, list of a particular author's articles, sorting of articles by keywords, search engine results, etc.)
126
 
127
{The site administrators can completely disable the display of the description in the &laquo;<A HREF="aide_index.php3?aide=confart" TARGET="_top">precise Configuration</A>&raquo; section.}
128
 
129
</artdesc>
130
 
131
<ins_img>
132
 
133
{{{Inserting images in the text}}}
134
 
135
SPIP offers the possibility to illustrate your articles and news with images. This will be achieved in a number of steps: you must send the image file to the site, then insert the image inside the text.
136
 
137
------
138
 
139
Preparing: {{Images formats}}
140
 
141
When you create your images (with your usual application), you must save them in one of the following formats:
142
 
143
- GIF; (extension {{.gif}})
144
- JPEG; (extension {{.jpg}})
145
- PNG (extension {{.png}}).
146
 
147
You should particularly make sure that your files names end up with an extension indicating their format: {{.gif}}, {{.jpg}} or {{.png}}. If you install a file with a missing extension in its name, the system will be unable to use the image.
148
 
149
------
150
 
151
Step 1: {{Installing the images on the server}}
152
 
153
<img src="AIDE/ins_img1.gif" alt=" "  border="0" align="right">Before you can insert your images in the text, you obviously have to install them on the server. This is achieved, in SPIP, through the graphical interface.
154
 
155
When you &laquo;modify&raquo; an article or a news item, the left column displays a form called:
156
&laquo;Add an image&raquo;. It takes the form of a {text field} followed by a button labelled (depending on the version of your browser) &laquo;Browse&raquo;, &laquo;Select&raquo;, &laquo;File&raquo; ...
157
 
158
When you click on this button, a dialogue box opens to allow you to browse your hard disk and select the graphic file you want.
159
 
160
Having done this, click on the button called: &laquo;Upload&raquo;.
161
 
162
If the operation succeeds, your image will appear in the left column, accompanied by several settings...
163
-------
164
 
165
Step 2: {{information concerning your image}}
166
 
167
<img src="AIDE/ins_img2.gif" alt=" "  border="0" align="right">Once your image sent to the server, a box appears on the left of the screen. It contains all the information concerning this image. (part of this information will be masked, click on the small triangle to &laquo;unfold&raquo; the information box).
168
 
169
{image size.} Just above the image, the width and height of your image (in pixels) are displayed.
170
 
171
- {display as thumbnail}. A preview of your image appears. If the image is too large (more than 200 pixels wide), a thumbnail of the image is displayed instead.
172
 
173
- {SPIP shortcuts}. see below: SPIP will remind you of the 3 &laquo;shortcuts&raquo;, which enable you to insert this image within your text. It is worth noting that every image is &laquo;numbered&raquo; thus: &laquo;IMG1&raquo;, &laquo;IMG2&raquo;... These &laquo;shortcuts&raquo; are used in the third step.
174
 
175
- {Image size}. Just above the image, its width and height (in pixels) are displayed.
176
 
177
- { Image title and description}. If you wish, you can enter a title and a description for each image, such as an explanation, the photographer copyright notice...
178
 
179
- {Delete this image}. As you can guess, &laquo;Delete this image&raquo; button allows you to delete this file, if you made a mistake or if you decide you do not want to use the image in the text. It is advisable to delete unused images to prevent clogging the server with unwanted files.
180
 
181
You can repeat this operation with as many images as you wish (an article or a news item can contain as many images as needed).
182
 
183
-------
184
 
185
Step 3: {{Inserting an image inside the text}}
186
 
187
At this stage, the graphic files are actually stored on the server, yet you need to indicate where they should be inserted in your text. There is no need to write HTML for that, SPIP offers you a &laquo;shortcut&raquo; enabling the insertion of your image easily.
188
 
189
- {Images without caption}
190
 
191
For each image, look at the 3 shortcuts:
192
- &lt;IMG1|left&gt;
193
- &lt;img1|center&gt;
194
- &lt;IMG1|right&gt;
195
 
196
Copy one of these shortcuts (the figure corresponds to the number of the image, it then changes for each file), and paste it inside the box called &laquo;Text&raquo;, at the location you want the image to appear. &laquo;left&raquo;  aligns the image to the left, &laquo;right&raquo;  to the right and &laquo;center&raquo;  centres your image in the text.
197
 
198
When the page is displayed, SPIP will replace these shortcuts by the corresponding HTML tags by automatically calculating the dimensions of the images.
199
 
200
- {Images with title and description}
201
 
202
If you entered a title and/or a description, the code &lt;img...&gt; is replaced with:
203
- &lt;doc1|left&gt;
204
- &lt;doc1|center&gt;
205
- &lt;doc1|right&gt;
206
 
207
These shortcuts are used in the same way as above; however, when you insert such a &laquo;shortcut&raquo;, SPIP inserts not only the image but the title and the description that you previously entered. Thus, your image appears with the eventual explanation, copyright notice, the name of the artist etc.
208
 
209
</ins_img>
210
 
211
<ins_doc>
212
 
213
{{{Attaching multimedia documents}}}
214
 
215
The SPIP interface allows you to integrate multimedia files to your site (sound, video, text,...).
216
 
217
Editors can attach documents to articles. These documents can be located either at the end of the text (a bit like &laquo;attachements&raquo;), or inside the text as a preview vignette (or thumbnail).
218
 
219
Site administrators can also install documents directly in the sections.
220
 
221
You should note the important difference between those two ways: in articles, documents are &laquo;attachements&raquo; which are useless without the article to which they are associated (in the site navigation, you can view these files from the articles); when they are installed directly in the sections, these documents become elements of the site like the articles and news, and not an information supplement anymore.
222
 
223
--------
224
 
225
Step 1: {{Installing the documents on the server}}
226
 
227
<img src="AIDE/ins_doc1.gif" alt=" "  border="0" align="right">The files installation on the server is performed through the interface &laquo;Attach document&raquo; for the articles and &laquo;Publish a document in this section&raquo; for the sections.
228
 
229
Notice that, for the articles, this interface appears in two different locations: at the bottom of each article's page and on the left (under the images) when you modify an article. Those two interfaces have exactly the same functions, and you can use either of them according to your needs. As for the sections, the documents installation is performed on the page required section itself.
230
 
231
Before you install your files, you have to create them on your computer. The document upload interface reminds you of the list of formats supported by the system. {You should make sure that you name your files with the correct extension (for instance, }&laquo;xxxxxx.mp3&raquo;{ for an MP3 file.})
232
 
233
The interface is the same as the one for the images: the button &laquo;File&raquo; or &laquo;Browse&raquo; (depending on the browser) opens a window allowing you to select the file on your hard drive. Once you select the file, click on &laquo;Upload&raquo; to send it to the server. {Warning: this operation can take a lot of time, depending on the size of the file. You should also note that depending on the settings of your host, big files could be rejected; in this case you can bypass this limitation by <A HREF="aide_index.php3?aide=ins_upload"
234
TARGET="_top">installing your files via FTP</A>.}
235
 
236
 
237
---------
238
 
239
Step  2: {{Information and vignette}}
240
 
241
<img src="AIDE/ins_doc2.gif" alt=" "  border="0" align="right">Once the file has been transferred to the server, an information box appears. Several operations can be performed therein.
242
 
243
- {Preview vignette}
244
 
245
This idea is very important: unlike images which can be inserted in the text, documents do not appear straight away. A preview vignette is displayed to the visitor who clicks on it, should he need the corresponding document.
246
 
247
The top part of the information box allows you to choose the preview vignette. You can accept the {default vignette} or install a {customised logo}.
248
 
249
The default vignette is installed automatically by the system, depending on the document format. The advantage of accepting this vignette is that the symbols of the documents of the same type for the whole site will be consistent.
250
 
251
If you prefer, you can install a logo (preferably small and of the format GIF, JPG or PNG), which will appear instead of the default vignette. Once this logo installed, a &laquo;Delete the customised vignette&raquo; link allows you to go back to the default vignette if necessary.
252
 
253
- In the article modification page, the &laquo;shortcuts&raquo; allowing you to insert a document in the text are identical to the images ones.
254
 
255
- The bottom part enables you to enter a title and a description for your document. There is no need to enter here the format or the size of the multimedia file, this information will be automatically provided by the publishing system.
256
 
257
- Finally, the button &laquo;Delete this document&raquo; deletes the unnecessary files. {You should note that it is imperative to delete unwanted documents, otherwise they would appear on the public site.}
258
 
259
- {{Concerning the documents installed in the sections,}} you can also modify the publication date of the document (according to the same principle of the modification of articles and news). Once these settings submitted, the sections documents are immediately available on the public site (there is no need to validate them like the articles and news).
260
 
261
 ---------
262
 
263
Step 3: {{Insert documents in articles text}}
264
 
265
Concerning the documents associated with articles, you can simply install them and enter the information (steps 1 and 2 above). When you publish the article, these documents will appear at the end of the text in as a list of {attached documents}.
266
 
267
However, you can also decide to insert the preview vignettes inside the text. You will have then, images that you can click inside the article.
268
 
269
The procedure here is exactly the same as the one for the images, the only difference is that the vignettes will be elements that you can click. Insert a shortcut like &lt;imgxx|yy&gt; or &lt;docxx|yy&gt; whether you want to display the vignette alone or with its title and description.
270
 
271
{You should note that} the documents that you install inside the text will not appear {under the article} anymore. For articles, there two locations where the documents appear: inside the text (vignette that you can click), or at the end of the article under the expression &laquo;Attached documents&raquo;.
272
 
273
----------
274
 
275
Special case: {{Video and sound documents}}
276
 
277
Some multimedia files are meant to be displayed directly on a web page (for instance, a video clip inserted directly in the article).
278
 
279
To be able to insert such documents inside the text as a multimedia animation and not as a vignette, you must enter its dimensions: width and height strictly greater than zero (for sound files you choose the width you wish to attribute to the play cursor and a low height such as 25~pixels).
280
 
281
{You should note that} the boxes allowing you to enter the dimensions will only appear for the documents of certain formats supported by SPIP for their integration in the articles (namely: avi, quicktime, real, flash).
282
 
283
Once you have entered these dimensions, an additional SPIP shortcut will be provided, in the shape of &lt;embxx|yy&gt; (as a reminder &laquo;{{emb}}ed&raquo;).
284
 
285
If you are very familiar with this sort of integration, you will be happy to know that you can add additional parameters such as:
286
 
287
<cadre>
288
<emb54|center|autostart=true|quality=hight>
289
</cadre>
290
 
291
</ins_doc>
292
 
293
<ins_upload>
294
 
295
{{{Install files via ftp}}}
296
 
297
Some servers do not allow file uploading through a web interface. furthermore, it could be very awkward to send large files that way. SPIP allows you to bypass these limitations by installing files used for images and documents by FTP.
298
 
299
Of course, this operation is restricted to users who have the connection code to the FTP server.
300
 
301
- {{The folder /ecrire/upload}}
302
 
303
With your FTP client, you just have to install your files (images, multimedia documents) in the folder /ecrire/upload of your SPIP site.
304
 
305
- {{The files drop-down menu}}
306
 
307
Having done that, a drop-down menu appears automatically after the interface of web files uploading and displays the files contained in this folder. You just have to select the file that you need and validate your choice.
308
 
309
If the operation succeeds, remember to delete the file from the folder /ecrire/upload (the system has created a copy of this file in another location on the server, your original file is therefore not needed anymore), to avoid jamming the drop-down menu.
310
 
311
- {{All the files at once}}
312
 
313
If you install several files at once in the folder /ecrire/upload, an additional feature will be available to you on the site interface: you can install all these files in one batch. This could prove to be very practical while creating fast portfolios.
314
 
315
</ins_upload>
316
 
317
<artmodif>
318
 
319
{{{Article in current editing}}}
320
 
321
When an editor opens an article to edit it, other participants visiting the page are notified and advised not to edit the article themselves.
322
 
323
As a matter of fact, if two editors intervene at the same time on the same article, the modifications entered by one of them could overwrite the modifications of the other.
324
 
325
If you see the notice &laquo;Warning, an editor intervened on this article&raquo;, it is strongly advised not to modify for the time being. Come back later to this article, to edit it when the other editor finishes his modifications and saves them.
326
 
327
On the other hand, when you yourself intervene on the article, the other participants who visit this page will be notified of your intervention. As long as you are in the modification process, and for {{an hour}}, the other editors are requested not to intervene on the text. When you think you have finished working on the article, then others can start intervening, you can &laquo;release&raquo; this article. The warning shown to the others will disappear which enables them to enter their modifications if necessary.
328
 
329
</artmodif>
330
 
331
<artmots>
332
 
333
{{{Keywords}}}
334
 
335
In order to diversify the navigation in the site, it is possible to attribute <A HREF="aide_index.php3?aide=mots" TARGET="_top">Keywords</A> to articles, news, and referenced sites. This way, not only the site visitor browses from section to section, but from an article dealing with a topic (indicated by a keyword) to another article associated with the same keyword as well.
336
 
337
It is possible to specify, for each article, news item or site, as many keywords as needed.
338
 
339
A drop-down menu lists all the keywords of the site. It is very easy to use. {Note: if the number of keywords exceeds 50, this drop-down menu is replaced by a search engine: just enter the desired keyword and click on &laquo;Search&raquo;.}
340
 
341
{{P.S.}} Only the administrators can create keywords from within the page dedicated to their management (the &laquo;Keywords&raquo; button in the top navigation bar).
342
 
343
{Administrators can disable the use of keywords for the whole site in the &laquo;<A HREF="aide_index.php3?aide=confart" TARGET="_top">precise Configuration</A>&raquo; section.}
344
 
345
</artmots>
346
 
347
<artprop>
348
 
349
{{{Submitting an article}}}
350
 
351
While an article is in progress (see the section &laquo;<A HREF="aide_index.php3?aide=artstatut" target="_top">Article status</A>&raquo;), it displays a button &laquo;asking for the publication of this article&raquo;.
352
 
353
{Only the article's author is allowed to perform this operation.}
354
 
355
This means that the article is &laquo;submitted for evaluation&raquo;, that is, submitted to all the other editors who are requested to comment on it while awaiting to be validated (published) or rejected by the administrators.
356
 
357
Warning: once the article is submitted for evaluation, it is not possible anymore for the author to reconsider his decision and to re-place his text in the &laquo;editing in progress&raquo; mode.
358
Consequently, the operation &laquo;Ask for the publication of this article&raquo; must only be performed after the author makes sure that his text is complete and final. Only an administrator can place the text again in the &laquo;editing in progress&raquo; mode.
359
 
360
</artprop>
361
 
362
<artrub>
363
 
364
{{{Selecting the section}}}
365
 
366
The menu shows the complete <A HREF="aide_index.php3?aide=rubhier" target="_top">sections hierarchy</A> (in the order in which they where created by the site administrators): select the section in which you want to place your article.
367
 
368
A lot of novice users seem to be oblivious to this feature though very simple, and drop their article &laquo;anywhere&raquo; in the site structure. Consequently, the administrators are advised to always check if an article is in the right section before validating it.
369
 
370
</artrub>
371
 
372
<artstatut>
373
 
374
{{{Article status}}}
375
 
376
The article {status} concerns its editorial situation in the site. the article can take the following states:
377
- editing in progress;
378
- submitted for evaluation;
379
- published online;
380
- to the dustbin;
381
- rejected.
382
 
383
These states, that only the administrators can modify, enable the site management.
384
 
385
{{P.S.}} the articles status is symbolised by coloured bullets.
386
 
387
<IMG SRC="img_pack/puce-blanche.gif"> {{editing in progress}}
388
 
389
When it is created, an article is of course considered as being in progress: its authors are in the process of writing it or modifying it ...
390
 
391
{When editing is in progress, the article appears only to its authors and to the administrators. the other site editors do not have access to it.}
392
 
393
<IMG SRC="img_pack/puce-orange.gif"> {{Submitted for evaluation}}
394
 
395
When the author considers that his article is ready, he &laquo;suggests&raquo; it to the other participants, so that it could possibly be discussed collectively, before being validated (published online) or rejected.
396
 
397
{When the  article is &laquo;submitted for evaluation&raquo;, it appears in the &laquo;Launch pad&raquo; page of all the users of the private area, who are requested to join in its discussion through the internal discussion forum located below the article.
398
 
399
Such an article is then visible to all editors. On the other hand, it can only be modified by its author or an administrator.}
400
 
401
<IMG SRC="img_pack/puce-verte.gif"> {{Published online}}
402
 
403
After being possibly discussed by the editors (during the submission stage), an article could be &laquo;validated&raquo;, that is, published online by an administrator. By then, it is available to all the visitors of the public site.
404
 
405
{When an article is published online, only the administrators can modify it. Its author cannot modify it anymore if he does not have the administrator status, and therefore have to ask an administrator to insert corrections.}
406
 
407
<IMG SRC="img_pack/puce-rouge.gif"> {{Rejected}}
408
 
409
A &laquo;submitted&raquo; article, which does not conform to the editorial line of the site, can be &laquo;rejected&raquo; if the administrators refuse to publish it online.
410
 
411
{A &laquo;rejected&raquo; article becomes visible only to its author and to the administrators.}
412
 
413
{However, a &laquo;rejected&raquo; article cannot be modified by its author anymore, hence stopping him from re-submitting it for publication. In the case of an article requiring modification, it is then advised to re-place the article in the &laquo;editing in progress&raquo; status instead of just &laquo;reject&raquo; it, in order for its author to be able to modify it and re-submit it later.}
414
 
415
<IMG SRC="img_pack/puce-poubelle.gif"> {{To the dustbin}}
416
 
417
An article can be sent &laquo;to the dustbin&raquo; only by an administrator.
418
 
419
{An article sent &laquo;to the dustbin&raquo; is not visible anymore in the private area, even for the administrators. Be careful then, this option is &laquo;radical&raquo;: the article disappears completely.
420
 
421
In fact, the article is still saved in the database, but becomes extremely difficult to reach with the tools provided by SPIP.}
422
 
423
Therefore, this option is reserved to articles created by mistake, and destined to be totally removed. Often then, it is advised to choose the &laquo;rejected&raquo; option instead because it is less dramatic.
424
 
425
 
426
- Finally, it is worth noting that the administrators can, at any time, modify the {status} of an article. Hence a published article could well be placed again in &laquo;editing&raquo; mode. However, once an article is published online, do not overdo these changes of status: you will end up with a site &laquo;full of holes&raquo;, with appearing and disappearing pages, which is very penalising for the visitor.
427
 
428
</artstatut>
429
 
430
<arttexte>
431
 
432
{{{The article's text}}}
433
 
434
Pretty straightforward: this is the {text} of your article as its name suggests.
435
 
436
- However, there is one point which could create a problem: the length of the text. It happens sometime that if the text is too long (according to our own experience, bigger than 32 Kb), it is truncated or indeed rejected during its transfer to SPIP. This problem is not caused by SPIP, but by the web browser that you are using. If you find yourself with a very long text for one browser, try to use another one.
437
 
438
- The article text is very well suited to the use of  SPIP's <A HREF="aide_index.php3?aide=raccourcis" TARGET='_top'>typographical shortcuts</A>
439
 
440
</arttexte>
441
 
442
<arttitre>
443
 
444
{{{Title, top title, subtitle}}}
445
 
446
- The {title} is compulsory.
447
 
448
- The {top title} and the {subtitle} are completely optional. If you do not need them, leave them blank, the site layout will adapt automatically to their presence or absence.
449
 
450
{Should they wish so, the administrators can disable the use of the top title and/or the subtitle in the &laquo;<A HREF="aide_index.php3?aide=confart" TARGET="_top">precise Configuration</A>&raquo; section.}
451
 
452
</arttitre>
453
 
454
<confart>
455
 
456
{{{Articles content}}}
457
 
458
The articles are made of a number of elements: the title, the top title, the subtitle, the description, the deck, the postscript... However, some sites do not need all these elements: either the editors do not use them or the graphical interface of the public site does not include them.
459
 
460
In order to lighten the site's management interface and/or simply to stop the editors from using certain elements that the webmaster does not wish to include, the &laquo;precise configuration&raquo; page allows to disable completely the use of these elements.
461
 
462
{{P.S.}} It is important to understand that, with regard to the choice of  <A HREF="aide_index.php3?aide=intersimple" target="_top">{simplified interface / complete interface}</A>, which only influences the interface of each user, the choice of the options of the &laquo;Precise configuration&raquo; influences all the users. So if you disable the use of the top title, no editor and no administrator could use top titles in his articles.
463
 
464
The interface will adapt to the presence or the absence of these elements. If you disable the use of keywords the corresponding button in the top navigation bar will simply disappear.
465
 
466
</confart>
467
 
468
<confbreves>
469
 
470
{{{Enabling/disabling the news system}}}
471
 
472
Some sites do not use {news}, i.e. short articles without author. Perhaps, the webmaster did not include them in the layout of the public site.
473
 
474
In this case, you can simply decide to disable them. So the editors cannot create them. The interface will be all the less burdened.
475
 
476
</confbreves>
477
 
478
<confmails>
479
 
480
{{{Automated e-mailing}}}
481
 
482
Editors and administrators do not necessarily spend their lives in the site management area. To facilitate collective work and follow-up of the site's life, the system can warn by e-mail of some events happening to it...
483
 
484
<FONT COLOR="red">Warning: some hosts disable the automated e-mailing feature. If you face this situation, the following options could not be enabled.</FONT>
485
 
486
- {{Follow-up of public forum messages}}
487
 
488
In order to enable the authors to follow the discussions triggered by their articles, this option offers to automatically forward to the author each message posted for his article.
489
 
490
If this option is enabled, the author(s) of the article will receive by mail the text of any message posted for their article as well as a reminder of this article's URL; with one click, he (they) can then go to the page of the article and should he (they) wish to, post an answer to the message.
491
 
492
- {{ Follow-up of editorial activity}}
493
 
494
When an article is submitted for validation or published, you can ask SPIP to notify about it by mail. This way, participants to the site are informed in real time of the important developments of the site.
495
 
496
For a collective site (several editors), we advise you to create a mailing list of editors (SPIP does not provide the mailing list feature), to which you can post messages.
497
 
498
- {{News announcements}}
499
 
500
This feature provided by SPIP offers to create e-mails of the kind &laquo;Latest news&raquo;: if you enable it and set up the delay between announcements, an e-mail is sent regularly to the specified address, summarising the latest published articles and news.
501
 
502
This feature is very simple to implement: if you enable this option by fixing the delay to 7 days, once every 7 days, SPIP will send the list of articles and news published during these 7 days to the specified address.
503
 
504
A &laquo;Send now&raquo; button triggers the immediate sending of this summary e-mail (and starts a new time interval of 7 days before releasing the next e-mail).
505
 
506
You can send this latest news announcement mail to the main webmaster's address (who will forward it), or, if you like the complete self-managed sites, you can send the mail to the list of your subscribers (SPIP does not provide the mailing list feature).
507
 
508
</confmails>
509
 
510
<confdates>
511
 
512
{{{Publication of post-dated articles}}}
513
 
514
It is possible for administrators to modify an article's <A HREF="aide_index.php3?aide=artdate" TARGET="_top">date of online publication</A> (when this article is declared as &laquo;published online&raquo;).
515
 
516
How should SPIP behave when we set this date of online publication to a value in the future? Should SPIP publish all the articles, whatever their publication date (risking an odd display with an article showing &laquo;31st of May 2002&raquo; while we are only on the 21st of May), or should it wait for the due date (here on the 31st of May) before displaying this article on the public site?
517
 
518
- The main advantage of this operation is to be able to schedule the publication of a series of articles in advance. Practically: the webmaster goes on holiday for a month; if he already wrote some articles, he can place them in the private area as &laquo;published online&raquo;, but set for them publication dates spread over the month while he is absent. That way, rather than publishing online a {bundle} of articles in one go, then nothing for a month, the site will regularly publish &laquo;new&raquo; articles despite the absence of their author.
519
 
520
- As for a science fiction site publishing a {Martian chronicle}, it should find it desirable to disable this feature, unless it wants to wait for the year 2030 to publish its stories. The same thing applies to a monthly online publication when it publishes its April issue on the 20th of March.
521
 
522
</confdates>
523
 
524
<confmessagerie>
525
 
526
{{{Internal messaging}}}
527
 
528
SPIP offers an internal messaging system (a section of the present documentation is dedicated to the <a href="aide_index.php3?aide=messut" target="_top">messages between users</a>, to the <a href="aide_index.php3?aide=messpense" target="_top">memos</a> and to the <a href="aide_index.php3?aide=messcalen" target="_top">calendar</a>).
529
 
530
You can decide to use all or parts of this system.
531
 
532
- {{ Enabling/disabling internal messaging}}
533
 
534
A reason for not using internal messaging could be the space that these messages take up in the database: these messages (such as the messages of the forums linked to your articles, for instance) are stored in the database and therefore take up disk space at your host's. Moreover, the internal messaging features add an additional burden on the machine which is hosting your site (database queries): in case of a low specification (and/or very slow) machine, you would rather lighten the task and disable messaging.
535
 
536
- {{Enabling/disabling the list of connected editors}}
537
 
538
If you enable this feature, the list of users connected to your site's  private area will show permanently. Notably, this will ease the exchange of instant messages between users.
539
 
540
This feature causes additional queries to the database; you would rather disable this features on a slow machine. It is worth noting that some users find this feature intrusive.
541
 
542
{You should note that:} When you enable the above features for the whole site, it is still possible, for every user, to <a href="aide_index.php3?aide=messconf" target="_top"> disable these features for his own use</a>. This way, if a user finds the internal messaging functions unnecessary or intrusive, he can simply disable this feature for his own use.
543
 
544
</confmessagerie>
545
 
546
<confforums>
547
 
548
{{{Operation of public forums}}}
549
 
550
The way to manage public forums varies from one webmaster to another, namely according to the actual needs of the site. Some webmasters do not want forums, some want free access forums, others still prefer to moderate the forums {beforhand}, by publishing the messages only after they were validated by an administrator.
551
 
552
SPIP allows you to determine the operation of your public forums (the forums which are internal to the site management are always managed as open forums for all the editors, and moderated {afterwards}).
553
 
554
- {{Disabling public forums}}
555
 
556
When the forums are disabled, the sending contributions interface disappears and the old contributions are no longer displayed (they are not deleted from the database, but their display is interrupted). This option stops the operation of the forums, even if the forums display is coded in the site layout (templates).
557
 
558
You can use it permanently (the site never provides discussion forums) or temporarily (suspend forums activity to calm a crazy spammer  or to go on a plane spotting holiday ...or even to transfer your site to another server).
559
 
560
- {{Afterwards moderated forums}}
561
 
562
When forums are moderated {afterwards}, contributions are displayed  as soon as the users post them. You are then free to use the forums follow-up page provided by SPIP to moderate these messages with various degrees of severity. {a posteriori moderation is the default mode for SPIP.}
563
 
564
- {{Beforhand moderated forums}}
565
 
566
In {beforhand} moderated  forums, users contributions are stored but not displayed. Administrators must use the forums follow-up page provided by SPIP to validate (or reject) each message.
567
 
568
- {{Forums accessed by subscription}}
569
 
570
If the forums are {accessible by subscription}, users wishing to contribute must register by providing their e-mail address. Then they receive their identification by e-mail. For editors who already have access to the private site, this identification corresponds to their usual login.
571
 
572
This mode is a compromise between the need for responsibility (the participants must provide a valid e-mail address) and the absence of beforhand moderation (once they are registered, these users can post their contributions directly).
573
 
574
Furthermore, this mode allows to exclude users who misuse forums ({black-list}). As a matter of fact, when you delete (via the forums follow-up page) a contribution posted in the &laquo;by subscription&raquo; mode, you can have access to the &laquo;file&raquo; (extremely small) of the author of this contribution. You can simply send this author &laquo;to the dustbin&raquo;: his identification will not work anymore and he will not be able to obtain a new one with the same e-mail address.
575
 
576
<FONT COLOR='red'>Warning: the mode &laquo;forum by subscription&raquo; requires that your host supports automated e-mailing. If this is not the case, change your host ;)</FONT>
577
 
578
</confforums>
579
 
580
<confmoteur>
581
 
582
{{{Enabling/disabling the search engine}}}
583
 
584
SPIP contains a search engine. When it is enabled, an articles indexing system analyses the content of all articles. This operation, even though offering subsequent extremely fast searches, requires a lot of work from the server hosting the site. In the case of a slow host, this will cause a few problems.
585
 
586
For this reason, you can enable or disable the system indexing.
587
 
588
Data managed by the search engine integrated to SPIP nearly {{treble}} the disk space used by the database. On the other hand, on slow or heavily loaded systems, indexing could cause a slight degradation of performance, or even execution errors (extreme case).
589
 
590
Generally, if your site is very large, we advise not to use the search engine integrated to SPIP, and to choose other specialised products such as <HTML><A HREF='http://www.htdig.org/' target="_blank">ht://Dig</A></HTML>.
591
 
592
You should also note that the search engine does not index all the pages in one go. If you enable it while your site contains already a big number of articles, you have to wait until your site records a number of hits (approximately) equal to the number of texts to index in order for the engine to be updated.
593
 
594
</confmoteur>
595
 
596
<confnom>
597
 
598
{{{Name and URL of your site}}}
599
 
600
The name and URL of your site are, in particular, used to generate the file &laquo;backend.php3&raquo; which allows the syndication of your site (i.e. display the last 10 articles published by your site in another site).
601
 
602
Your site's URL must be the address of the homepage {folder} not that of  the corresponding HTML file; therefore it must be ended with the character &laquo;/&raquo;. If your homepage address is:
603
 
604
<HTML><TT>http://www.mysite.net/index.html</TT></HTML>,
605
 
606
Your site's URL should be written thus:
607
 
608
<HTML><TT>http://www.mysite.net/</TT></HTML>
609
 
610
</confnom>
611
 
612
<confstat>
613
 
614
{{{Visits statistics}}}
615
 
616
SPIP contains a very simple system allowing you to count and track the number of visits to the site and to each article. It also allows you to know which other sites directed visitors to your site and to each article.
617
 
618
- {{Number of visits}}
619
 
620
Every day, SPIP identifies &laquo;unique visitors&raquo; to your site according to their IP address. The system is fast and {relatively} reliable (it is a {relatively} accurate estimate of the number of visitors to the site, and not just &laquo;hits&raquo; or &laquo;watched pages&raquo;; a visitor coming back several times to the same page is counted as a unique &laquo;unique visitor&raquo;).
621
 
622
- {{Direct visits or referrers}}
623
 
624
A &laquo;direct visit&raquo; is an arrival to the site or to an article's page from another web site which contains a hypertext link to your own site (the former is itself considered as a &laquo;referrer&raquo;).
625
 
626
For the entire site and for each article, SPIP displays the list of the main &laquo;referrers&raquo; (the pages displaying a hypertext link to your site), accompanied by the number of &laquo;direct visits&raquo; (the number of visitors who followed this link).
627
-----
628
 
629
- {{A &laquo;relatively&raquo; reliable system}}
630
 
631
A complete system for traffic analysis is a very demanding application in terms of power and memory; therefore, the SPIP system is very simplified in order to be as fast as possible and as small as possible on the server's hard drive. Furthermore, the counting of &laquo;unique visitors&raquo; is based on the visitors IP address every day, which is not the most precise method, we think, however, that it provides a  &laquo;relatively&raquo; reliable information.
632
 
633
If you want a thorough information of your site's traffic, you could use another system more specialised in statistical analysis.
634
 
635
- {{A daily calculation}}
636
 
637
The traffic follow-up system integrated to SPIP performs calculation of the number of visitors and referrers daily (not in real time). Consequently, some information could sometime look incoherent because it does not integrate the visits of the actual day, if in doubt, the specific page displaying the statistics is the one most reliable and detailed. Therefore, the statistics page of an article is only available after the first day of publication of that article (figures are unknown before that because SPIP has not analysed them yet).
638
 
639
- {{Enabling/disabling statistics and referrers}}
640
 
641
The counting of the number of unique visitors should not occupy a lot of space neither use a lot of computing power. There is no point, then, to disable it unless the server is very slow.
642
 
643
On the other hand, the system of counting referrers and direct visits is more demanding. it is, therefore, disabled by default. It is advised to enable it only on servers with no problems in computing power (servers which already struggle to calculate lengthy articles cannot surely cope with the burden of referrers calculation).
644
 
645
- {{PS:}} Disk space and computing time necessary for the follow-up of visits and referrers increase with your site's traffic. The more a site is visited, the more the technical needs to perform these tasks increases.
646
 
647
</confstat>
648
 
649
<install0>
650
 
651
{{{Preliminary: Setting up permissions}}}
652
 
653
When you install SPIP files by FTP on your own server, some {{directories}} will not be configured correctly: therefore, you must modify their configuration through your usual FTP client.
654
 
655
You have to modify the  &laquo;permissions&raquo; of the following directories:
656
- {{/CACHE}}
657
- {{/IMG}}
658
- {{/ecrire}}
659
- {{/ecrire/data}}
660
 
661
FTP &laquo;clients&raquo; differ in their functions but the procedure is generally thus:
662
 
663
- select the folder of which you want to modify the &laquo;permissions&raquo;;
664
 
665
- find in your FTP client a feature called &laquo;change (or {modify} or {set} permissions&raquo;;
666
 
667
- If this feature appears as a graphical interface, check the box corresponding to &laquo;Write&raquo; for the &laquo;Others&raquo; (or &laquo;World&raquo; or &laquo;All users&raquo;):
668
<CENTER><img src="AIDE/install0.gif" alt=" "  border="0"></CENTER>
669
 
670
- If this feature appears in &laquo;text&raquo; mode, the numeric configuration is &laquo;777&raquo;.
671
 
672
When you make this modification for every directory indicated by the installation system, you must reload the page and the procedure resumes automatically.
673
 
674
</install0>
675
 
676
<install1>
677
 
678
{{{Your MySQL connection}}}
679
 
680
This step consists of entering the necessary information for the connection of SPIP to MySQL  server.
681
 
682
- {Database address:} depending on your host's choice, this information will simply be &laquo;localhost&raquo;, or your site's address (&laquo;www.mysite.org&raquo;).
683
 
684
- {Connection login:} it is often the same login you use to upload your files by FTP.
685
 
686
- {Connection password:} it is often the same password as the one you use  to access your site by FTP.
687
 
688
- These settings cannot be invented: not knowing them means that your host has not given them to you. Therefore: if you do not have this information at hand you cannot continue.
689
 
690
- These settings are provided to you {{ by the host of your site}}: to obtain them, you must contact him directly (do not ask the SPIP development team to give them to you, we do not know them!). Some hosts provide such information in an online guide.
691
 
692
- You should note that very often, you have to {{ask}} your host to activate your MySQL access, or complete yourself a specific procedure for that. Several hosts claiming to provide support for MySQL databases do not activate this connection automatically at the time of the setting up of a site; an additional request from your part (after opening your account with this host) is often necessary. In this case, refer to the documentation provided by your host to know how to {activate} your MySQL connection. (Again, the SPIP team cannot help you here.)
693
 
694
</install1>
695
 
696
<install2>
697
 
698
{{{Choosing your database}}}
699
 
700
- You must select the {name} of the database that was attributed to you by your host. This information is provided to you by your host: if you do not have it, ask him or refer to the online documentation provided by this host (it is no use requesting it from the SPIP development team, we do not have this information).
701
 
702
- Very often, this information correspond to the {login} of your hosting account (the one you use to connect to your site by FTP).
703
 
704
- First option (more often than not): an accounts list is displayed (sometimes a bit longish, depending on the configuration set by the host). Amongst the shown accounts, only one corresponds to yours, you simply select it then and validate it to go through to the next step.
705
 
706
- Second option: only one name, corresponding to your account, is displayed (your host has automatically configured his system to only display your account). Easy: select this account and validate.
707
 
708
- Third option (generally, for a professional account or on a server over which you have extended rights): you must {create} your own database. In this case (after verifying that such an account does not exist in the above list), you can enter the name of your choice next to the instruction &laquo;create a new database&raquo;.
709
 
710
- Last option (failure): your account does not appear in the displayed list, and you cannot create one yourself. It is a rare occurrence: this means that your host created an access for you to the database server, but forgot to create your account. In this case, you should contact your host directly.
711
 
712
</install2>
713
 
714
<install5>
715
 
716
{{{Personal information}}}
717
 
718
This step is very simple, but it should be completed carefully. Indeed, it is this step that determines your site connection identification! if you proceed hastily, you might not be able to connect...
719
 
720
Note that once your site is installed, you will have the possibility to change this information.
721
 
722
- {Your public identity:} that is what will appear as a signature of your articles.
723
 
724
- {Your connection identification:} this the identification that {{you yourself choose}} to connect to your own SPIP system. This information does not need to be identical to the one your host gave you to connect to your account by FTP. On the contrary, {we urge you not to use the same identification} for your access to SPIP (which you choose freely) and for your FTP connection (imposed to you by your host).
725
 
726
</install5>
727
 
728
<intersimple>
729
 
730
{{{Simplified interface / complete interface}}}
731
 
732
Each SPIP user can modify his own display (without affecting the display for the other users, contrary to the &laquo;<A HREF="aide_index.php3?aide=confart" TARGET="_top">Precise configuration</A>&raquo; page).
733
 
734
Several SPIP features are very rarely used (or not at all) by some editors. Therefore, choosing the &laquo;simplified interface&raquo; allows to lighten this interface and to simplify its comprehension. In this mode, only the elements really necessary to the management of the site are displayed. For example, very few users need the &laquo;<A HREF="aide_index.php3?aide=artdate_redac" TARGET="_top">date of earlier publication</A>&raquo; which does not appear in the &laquo;simplified interface&raquo; mode.
735
 
736
{{P.S.}} the differences between the two mode of display are more obvious to the administrators who have at their disposal more features than the editors of the site.
737
 
738
{For these modifications to take effect, you must accept the use of cookies.}
739
 
740
</intersimple>
741
 
742
<logoart>
743
 
744
{{{Article's logo}}}
745
 
746
With SPIP you can install a logo corresponding to the article. This way, it will be possible, in the public site, to display a graphic button linking to the article.
747
 
748
For an article, it is possible:
749
- not to use any logo;
750
- to install a simple graphical logo;
751
- to use an animated logo that supports &laquo;hovering&raquo; (a logo with &laquo;2 positions&raquo;: the logo changes when the mouse hovers over it).
752
 
753
- {{Images formats}}
754
 
755
When you create your images (with your usual application), you must save them in one of the following formats:
756
- GIF (the GIF file could be an &laquo;animated GIF&raquo;);
757
- JPEG;
758
- PNG (we advise against it because several browsers do not support it correctly).
759
 
760
{In order to avoid serious operating errors, SPIP rejects image files bigger than 256 KB.} Advice: because these &laquo;buttons&raquo; are elements of the graphical interface, make sure that their {file size} (in kilobytes) is not too big (generally, less than 10 KB) if you want your site navigation to remain fluid.
761
 
762
In particular, make sure that the names of your files have an {extension} indicating their formats: {{.gif}}, {{.jpg}} or {{.png}}. the file name itself is of no importance whatsoever provided that {you do not forget the extension}.
763
 
764
{If you create a button which supports &laquo;hovering&raquo;, create two different graphic files (one for the &laquo;normal&raquo; state of the button and another one that appears when the mouse hovers over the button): it is imperative, then, that the two files have the same size (in pixels).}
765
 
766
- {{Simple logo}} (no hovering)
767
 
768
<img src="AIDE/logoart-1.gif" alt=" "  border="0" align="right">To add a button, a box is provided in the left column of the article, under the title &laquo;ARTICLE'S LOGO&raquo;.
769
 
770
Depending on your browser version, click on the button &laquo;Browse&raquo;, &laquo;Select&raquo;, &laquo;File&raquo;...which opens a dialogue box allowing to select the graphic file corresponding to your button from your hard drive.
771
 
772
Once the file is selected, click on the button &laquo;Upload&raquo;. Et voil&agrave;...! your button appears. It is followed by a button &laquo;Delete logo&raquo; that simply offers you to delete this logo.
773
 
774
If you do not plan to use a hovering logo, no more steps are needed.
775
 
776
- {{Replacing the logo}}
777
 
778
<img src="AIDE/logoart-2.gif" alt=" "  border="0" align="left">You could wish to replace the logo with another file. This is achieved in two steps:
779
- start by &laquo;Deleting the logo&raquo;: the previous box, containing the &laquo;Upload&raquo; button reappears;
780
- upload the new file, according to the procedure already described.
781
 
782
Due to the browsers way of work, the image which is displayed then, is wrong, since it is in fact the previous version (the image is in the browser's &laquo;cache&raquo;). Click on this image (with the right button of your mouse, or while pressing the &laquo;ctrl&raquo; key on the Macintosh) to show a contextual drop-down menu: select the option &laquo;Reload image&raquo;. The new version of your logo will then appear.
783
 
784
- {{Logo for hovering}}
785
 
786
<img src="AIDE/logoart-3.gif" alt=" "  border="0" align="right">After installing the first file, the box displays not only the logo you have just installed on the server, but adds to it a second box, entitled &laquo;HOVERING LOGO&raquo;. It is in this box that you can select the second file aimed at the management of hovering.
787
 
788
{If, after installing both files, you delete the first one (the &laquo;simple&raquo; button), the box of the second logo disappears. Indeed, in the absence of the first logo, there is no point in managing any hovering!}
789
 
790
No intervention in the &laquo;text&raquo; of your article is necessary. At the time of the display on the public site, the management of the sections logos is entirely automated. The HTML code will be generated according to the size of the logo, and the hovering instructions in JavaScript will be created automatically as well.
791
 
792
</logoart>
793
 
794
<raccourcis>
795
 
796
{{To make the layout of the documents published by SPIP easier, the system offers a number of &laquo;SPIP shortcuts&raquo; aiming at:
797
- simplifying its use for users who do not know HTML;
798
- simplifying the automated processing of page layout.
799
 
800
So naturally you can still use HTML code in your SPIP documents, but we advise you to use preferably these few SPIP shortcuts, which are much easier to remember and especially, provide the system with some automated operations.}}
801
 
802
~
803
 
804
{{{SPIP typographical shortcuts}}}
805
 
806
- {{Creating paragraphs}}
807
 
808
To create paragraphs, you simply leave a blank line, a bit like separating paragraphs in a e-mail (by &laquo;skipping&raquo; a line).
809
The simple &laquo;line feed&raquo; (enter or return) without separating the two paragraphs is insufficient to create a new paragraph (as a matter of fact, it does not even create a line feed).
810
 
811
You can leave several consecutive blank lines without altering the layout. As far as SPIP is concerned, a single blank line or several ones mean the same thing: a new paragraph, without any effect on the space between paragraphs.
812
 
813
- {{Creating bulleted or numbered lists}}
814
 
815
You can create lists in SPIP in the same way as in an e-mail: you only enter a line feed and start the new line with a dash (&laquo;-&raquo;).
816
 
817
Notice that, here, a simple line feed is enough (you can create lists in the same paragraph); but if you leave a blank line before the one starting with a dash, a blank line will appear before the list[[
818
{{Alternative:}}
819
- A simple line skip without a bullet can be obtained by entering <tt>_</tt> (underscore) at the beginning of the line, followed by a space.
820
- You can create nested lists by adding stars after the list dash.
821
_{Try this, for insatance}:
822
_ <html><tt>-* Your horse is<br>
823
-** chestnut;<br>
824
-** bay;<br>
825
-** black;<br>
826
-* but my rabbit is<br>
827
-** white:<br>
828
-*** angora or<br>
829
-*** short-haired.</tt></html>
830
- Finally, you can create numbered lists by using the <code>#</code> instead of the star:
831
<code>-# first
832
-# second
833
-# third</code>
834
gives:
835
-# first
836
-# second
837
-# third
838
]].
839
 
840
For instance, <HTML><TT><BR>
841
- I like work;<BR>
842
- it fascinates me.<BR>
843
- I can sit and look at it for hours.</TT></HTML> (Jerome K. Jerome) <BR> will be displayed thus:
844
- I like work;
845
- it fascinates me.
846
- I can sit and look at it for hours.
847
 
848
{{Bold and italic}}
849
 
850
You specify a text in {italic} by placing it between simple braces: &laquo;<HTML><TT>...some text {in italic} in...</TT></HTML>&raquo;.
851
 
852
You specify a text in {{bold}} by placing it between double braces: &laquo;<HTML><TT>...some text {{in bold}} in...</TT></HTML>&raquo;.
853
 
854
- {{Paragraph headings}}
855
 
856
Paragraph headings are titles inside a text that show its structure. In SPIP, they are very simply defined by placing them between treble braces: &laquo;<HTML><TT>{{{Section heading}}}</TT></HTML>&raquo; gives: {{{Section heading}}}
857
 
858
- {{Horizontal rule}}
859
 
860
It is very simple to insert a horizontal rule (or a separation line) across the width of the text: you just insert a line containing only a series of at least four dashes, thus:
861
<HTML>---- </HTML>
862
----
863
 
864
- {{Hypertext links}}
865
 
866
You can easily create a hypertext link with the following code:
867
&laquo;<HTML><TT>SPIP is an initiative of  [minirezo->http://www.minirezo.net/].</TT></HTML>&raquo; which becomes &laquo;SPIP is an initiative of [minirezo->http://www.minirezo.net/].&raquo;
868
 
869
The link's URL can be absolute (starting, as in this example, with <code>http://</code>), relative (to another page of the same site), a link to a document using an internet protocol (<code>ftp://</code>...) an e-mail address (&laquo;<code>[->mailto:minirezo@rezo.net]</code>&raquo;)...
870
 
871
- {{Hypertext links inside the site}}
872
 
873
Furthermore, this same hypertext links system makes it easy to create links inside your site with SPIP. the only trick consists of finding the {number} of the article or the section or the news item to which you want to link:
874
<img src="AIDE/articlenumero.gif" alt="NUMERO"  border="0" align="right">
875
when you &laquo;visit&raquo; an article, a news item or a section in the private area, the left column contains a box indicating this number in large digits.
876
 
877
This is the number that you should insert in the hypertext link:
878
 
879
{link to article 342 (4 possibilities):}
880
<HTML><TT>
881
<BR>link to [article->342]
882
<BR>link to [article->art342]
883
<BR>link to [article->article 342]
884
<BR></TT></HTML>{as for }<HTML><TT>[->art342]</TT></HTML>, {it will display the title of article 342 with a link to that article.}
885
 
886
{link to section 12:}
887
<HTML><TT>
888
<BR>link to [section->rub12]
889
<BR>link to [section->rubrique 12]
890
</TT></HTML>
891
 
892
{link to news item 65:}
893
<HTML><TT>
894
<BR>link to [news item->br65]
895
<BR>link to [news item->breve 65]
896
<BR>link to [news item->br&egrave;ve 65]
897
<BR></TT></HTML>
898
 
899
{Authors, keywords, sites:}
900
<HTML><TT>
901
<BR>[->aut13] ou [->auteur13]
902
<BR>[->mot32]
903
<BR>[->site1]
904
<BR>
905
</TT></HTML>
906
{Note that for a site the shortcut points to the URL of the referenced site. For a document ar an image, the title will be displayed if it exists, otherwise it is the file name that is displayed.}
907
 
908
- {{Hypertext links to an external glossary}}
909
 
910
You can also very quickly, create a hypertext link to the definition of an expression in an external glossary. For a given expression, you just have to insert the shortcut <code>[?expression]</code> in your text. That way, you can enrich your text with references without having to enter a web address!
911
 
912
So the following code:
913
"<code>{Mansfield Park} is a major work by [?Jane Austen]</code>".
914
displays thus:
915
"{Mansfield Park} is a major work by [?Jane Austen]".
916
By clicking on the link, you can verify that the expression you entered (a name or a noun) is correctly spelled and that it directs you to a valid destination.
917
 
918
The default glossary is [Wikipedia->http://www.wikipedia.org]. It is a multilingual encyclopaedia created co-operatively and opened to all contributors over the internet.
919
Please take the time to acquaint yourself with it, to respect it and to contribute to it in order to enrich this shared fund of knowledge.
920
 
921
- {{Footnotes}}
922
 
923
A footnote is usually indicated by a number inserted in the text then repeated at the bottom of the page and offering additional information.
924
 
925
In SPIP, this feature (pretty awkward to manage manually in HTML) is automated: the footnotes are numbered by SPIP which also manages the hypertext links inside the document to jump directly from the number to the corresponding footnote and vice versa.
926
 
927
In SPIP, a footnote is placed between double brackets: &laquo;<HTML><TT> A[[Here is additional information.]] footnote.</TT></HTML>&raquo; will be displayed as: &laquo;A[[Here is additional information.]] footnote.&raquo;
928
 
929
{Non-automated footnotes}
930
 
931
In most cases, the system of automated footnotes described above is more than sufficient. However, you can manage footnotes in a non-automated way.
932
 
933
For example:
934
 
935
&laquo;<HTML><TT>You can use automated numbered footnotes [[by placing the footnote text between brackets.]],<BR>
936
- but you can also force the footnote numbering [[&lt;23&gt; by indicating the number of the footnote between the symbols &laquo;&lt;&raquo; and &laquo;&gt;&raquo;.]],<BR>
937
- use footnotes in the shape of asterisks [[&lt;*&gt; simply by placing an asterisk between the symbols &laquo;&lt;&raquo; and &laquo;&gt;&raquo;.]],<BR>
938
- create footnotes without reference (not numbered) [[&lt;&gt; by inserting nothing between the symbols &laquo;&lt;&raquo; and &laquo;&gt;&raquo;.]],<BR>
939
- give a name (in full) to a footnote [[&lt;Sha&gt; William Shakespeare.]];<BR>
940
- refer to an already existing footnote [[&lt;23&gt;]] by indicating this footnote's number between the symbols &laquo;&lt;&raquo; and &laquo;&gt;&raquo; and leaving the rest of the footnote blank. </TT></HTML>&raquo;
941
 
942
All this gives:
943
 
944
&laquo;You can use automated numbered footnotes [[by placing the footnote text between brackets.]],
945
- but you can also force the footnote numbering [[<23> by indicating the number of the footnote between the symbols &laquo;<&raquo; and &laquo;>&raquo;.]],
946
- use footnotes in the shape of asterisks [[<*> simply by placing an asterisk between the symbols &laquo;<&raquo; and &laquo;>&raquo;.]],
947
- create footnotes without reference (not numbered) [[<> by inserting nothing between the symbols &laquo;<&raquo; and &laquo;>&raquo;.]],
948
- give a name (in full) to a footnote [[<Sha> William Shakespeare.]];
949
- refer to an already existing footnote [[<23>]] by indicating this footnote's number between the symbols &laquo;<&raquo; and &laquo;>&raquo; and leaving the rest of the footnote blank.&raquo;
950
 
951
- {{Tables}}
952
 
953
To create simple tables in SPIP, you just have to create lines with &laquo;cells&raquo; separated by the symbol &laquo;|&raquo; ({vertical line}), making sure that the lines start and end with vertical lines. It is imperative to leave blank lines before and after this table.
954
 
955
For example, the table:
956
 
957
| {{Surname}} | {{Forename}} | {{Age}} |
958
| Smith | John | 23 years |
959
| Captain | | not known |
960
| Bloggs | Philip | 46 years |
961
| Cadoc | Baby | 4 months |
962
 
963
is coded thus:
964
 
965
<HTML><TT>
966
| {{Surname}} | {{Forename}} | {{Age}} |<BR>
967
| Smith | John | 23 years |<BR>
968
| Captain | | not known |<BR>
969
| Bloggs | Philip | 46 years |<BR>
970
| Cadoc | Baby | 4 months |<BR>
971
</TT></HTML>
972
 
973
- {{Bypassing SPIP shortcuts}}
974
 
975
In some cases, it could be useful to tell SPIP that some parts of a document should not be &laquo;processed&raquo; by the typographical shortcuts filter: you do not want to correct the typography or you want to display source code (i.e. in PHP, JavaScript...)...
976
 
977
The code of this shortcut is: &laquo;<HTML><TT>&lt;HTML&gt;Warning; text to leave as is&lt;/HTML&gt;</TT></HTML>&raquo;, which gives: &laquo;<HTML>Warning; text to leave as is</HTML>&raquo;.
978
 
979
For example, the present article is typed under SPIP and it displays the source code of SPIP's shortcuts; if we had not used this code, the shortcuts would have been interpreted and you would not be able to read there source code here!
980
 
981
- {{Displaying programming code}}
982
 
983
Some users could wish at one point to display programming code in their pages. The shortcut <HTML><TT><code>...</code></TT></HTML> is available for this purpose.
984
 
985
Example: <HTML><TT><code><?php &nbsp; &nbsp; //this is some php code<br>
986
echo "hello";<br>
987
?></code></TT></HTML> gives <code><?php  //this is some php code
988
echo "hello";
989
?></code>
990
 
991
----
992
 
993
</raccourcis>
994
 
995
<rubhier>
996
 
997
{{{Hierarchical structure of the sections}}}
998
 
999
The sections structure constitutes the framework of your site; it is this structure which will determine its interface, its way of navigation, the relationship between articles and news...
1000
 
1001
In SPIP, this structure is of the {hierarchical} type: a section can contain sub-sections which can contain other sub-sections themselves, and so on.
1002
 
1003
<CENTER><IMG SRC="AIDE/rubhier-1.gif" BORDER=0 ></CENTER>
1004
 
1005
In the above example, we clearly see that section~222 relates to section~22, which itself relates to section~2 which does not relate to any other section (in this case, we say that section~2 is {in the site root}.
1006
 
1007
{By hierarchical structure we mean that a section is a child of only one other section (and not of several) and that a section cannot be the child of one of its own sub-sections (which means that SPIP does not allow circular structures). This very classical structure was adopted because of its ease of use.}
1008
 
1009
{{Only administrators can create, modify or delete sections.}}
1010
 
1011
</rubhier>
1012
 
1013
<rubsyn>
1014
 
1015
{{{Syndicated sites}}}
1016
 
1017
Sites developed by an automated publishing system (like SPIP or phpNuke) can easily create a file indicating always the list of their latest publications. In particular, there is standard format for this sort of file called &laquo;backend file&raquo;.
1018
 
1019
This file can be easily and automatically analysed in order to fetch constantly the list of latest news of such sites. That way, SPIP allows you to display, on your own site, the list of the latest articles published by other sites.
1020
 
1021
For each <a href="aide_index.php3?aide=reference" target="_top">referenced site</a> in your own sections, you have the possibility to fetch the list of the latest articles published on that site. That is, of course, if the referenced site offers a {backend} file.
1022
 
1023
- {{How to find the files &laquo;backend.php3&raquo;?}}
1024
 
1025
For sites managed under SPIP or phpNuke, those {backend} files are easy to locate: that is simply the file located in the site root and called &laquo;bakend.php3&raquo; (or &laquo;backend.php&raquo;). For example, concerning uZine (<TT>http://www.minirezo.net/</TT>), the backend file address is:
1026
 
1027
<LI><TT>http://www.minirezo.net/backend.php</TT>
1028
Other examples of backend files include:
1029
<LI></HTML><TT>http://www.davduf.net/backend.php</TT></HTML></LI>
1030
<LI></HTML><TT>http://www.vacarme.eu.org/backend.php</TT></HTML></LI>
1031
<LI></HTML><TT>http://www.vakooler.com/backend.php</TT></HTML></LI>
1032
 
1033
You should note that {<A HREF="http://rezo.net/backend" TARGET="autre">L'autre portail</A>} provides such files for the sites which it references, even if those sites do not have their own backend system. You will find on that page about thirty backend files for the sites referenced by {L'autre portail}, as well as a handful of theme files.
1034
 
1035
- {{Adding a syndicated site to your own site}}
1036
 
1037
When you reference a site in one of your sections, in addition to indicating the name of the site, its homepage URL and a description, you can choose to syndicate it (therefore, a syndicated site is primarily a referenced site from which we ask SPIP to fetch the list of the latest publications).
1038
 
1039
To achieve this, select the option &laquo;syndication&raquo; and enter the URL of the {backend} file of the desired site. Immediately after submitting, a message appears to tell whether the syndication has succeeded.
1040
 
1041
If the syndication fails:
1042
- make sure you entered the correct URL for that site;
1043
- make sure that the site you are trying to syndicate is actually accessible online.
1044
 
1045
- {{Quick referencing}}
1046
 
1047
The quick site referencing feature (enter directly the site's URL and SPIP will undertake the task of fetching the necessary information automatically) is very well suited to syndicated sites. Indeed, instead of entering the homepage URL during the referencing, you should enter the {backend} file URL of this site: SPIP will automatically fetch a big volume of information and proceeds directly with the syndication.
1048
 
1049
- {{Syndicated articles}}
1050
 
1051
When the syndication succeeds, SPIP displays the list of the latest articles published by that site. Look at the help page dedicated <a href="aide_index.php3?aide=artsyn" target="_top">to the management of those links</a>.
1052
 
1053
- {{The backend file of your own site}}
1054
 
1055
SPIP automatically creates the backend file of your own site. However, do not forget to set up the name and the URL of your site on the <A HREF="aide_index.php3?aide=confnom" TARGET="_top">Precise configuration</A> page.
1056
 
1057
 </rubsyn>
1058
 
1059
<rublogo>
1060
 
1061
{{{Section's logo}}}
1062
 
1063
<A HREF="aide_index.php3?aide=logoart" TARGET="_top"><img src="AIDE/logoart-2.gif" alt=" "  border="0" align="right"></A>
1064
You can install on your site a logo for each section. This logo could be unique (fixed image) or animated to manage mouse hovering.
1065
 
1066
The images installation for this section logo is exactly the same as the installation of the <A HREF="aide_index.php3?aide=logoart" TARGET="_top">article's logo</A>.
1067
 
1068
{{P.S.}} The section logos have a {recursive} behaviour: in case of a logo missing for a given section, SPIP will try to substitute it with the logo of a parent section:
1069
 
1070
<CENTER><IMG SRC="AIDE/rubhier-1.gif" BORDER=0 ></CENTER>
1071
 
1072
In the above hierarchy, and in case of a missing logo for section~221, SPIP will substitute it (only for the visit of the public site) with the logo of section~22 or if the latter is also missing with the logo of section~2. Otherwise, SPIP will display the logo installed in the site root.
1073
 
1074
You should note also that, if the webmaster has programmed it that way, a section logo could be used as a substitution logo for the articles that this section contains.
1075
 
1076
</rublogo>
1077
 
1078
<rubrub>
1079
 
1080
{{{Selecting the section}}}
1081
 
1082
The operation of this drop-down menu is very simple: the menu displays the whole section hierarchy (in the order in which the site administrators created them), you just have to select the one in which you want to place your sub-section.
1083
 
1084
- {{moving a section}}
1085
 
1086
<CENTER><img src="AIDE/rubrub.gif"  border="0"></CENTER>
1087
 
1088
Through this drop-down menu, you can transfer this section to being the child of another section. In this case, you must understand that the set of sub-sections contained in this section will &laquo;move&raquo; along with it in the hierarchy of the site. In the same way, the articles contained in this section and its sub-sections will move along with it.
1089
 
1090
</rubrub>
1091
 
1092
<breves>
1093
 
1094
{{{News}}}
1095
 
1096
News are a simple and fast method of publication in SPIP. Unlike articles, news are made of a very small volume of information: a title, a text and a hypertext link. Therefore, the news system is ideal for a follow-up of current events, a press review, etc.
1097
 
1098
</breves>
1099
 
1100
<brevesrub>
1101
 
1102
{{{Location of news in the site structure}}}
1103
 
1104
In order to ease their use (and to avoid redundancy between news and articles), integration of news in the sections hierarchy is reduced to the bare minimum: news relate only to sections located at the root of the site.
1105
 
1106
<CENTER><img src="AIDE/rubhier-1.gif" alt="Sections"  border="0"></CENTER>
1107
 
1108
In our example, we can put news in sections 1 and 2 but not in their sub-sections (unlike articles which we can put anywhere). Thereby, the layout of the news page is created in terms of these upper sections and the drop-down menu that offers to set the position of the news is very short indeed.
1109
 
1110
</brevesrub>
1111
 
1112
<breveslien>
1113
 
1114
{{{News hypertext links}}}
1115
 
1116
In order to ease the use of news as part of an online press review, each news item can be attributed a hypertext link. You just indicate the name of the referenced  site or article and its URL.
1117
 
1118
Of course, this information is optional.
1119
 
1120
{P.S.} This links system does not prevent the insertion of hypertext links in the body of the news item's text, but the {separate} hypertext link allows the webmaster to apply a specific graphical treatment to it.
1121
 
1122
</breveslien>
1123
 
1124
<brevesstatut>
1125
 
1126
{{{News status}}}
1127
 
1128
The management of a news item is simpler than that of an article. A news item does not have an author. Its status is either &laquo;Submitted&raquo; or &laquo;Validated&raquo; or &laquo;Rejected&raquo;. Only administrators can modify its status.
1129
 
1130
- {{News item Submitted}}
1131
 
1132
&laquo;Submitted&raquo; news items are indicated on the page &laquo;Launch pad&raquo;: all the editors can consult them and edit them. Administrators are presented with two buttons - allowing their validation or rejection.
1133
 
1134
- {{News item validated}}
1135
 
1136
&laquo;Validated&raquo; news items are those that appear on the public site. Only administrators can edit them then.
1137
 
1138
- {{News item rejected}}
1139
 
1140
A &laquo;rejected&raquo; news item is not published on the public site and only administrators can have access to it in the private site.
1141
 
1142
</brevesstatut>
1143
 
1144
<breveslogo>
1145
 
1146
{{{News item's logo}}}
1147
 
1148
<A HREF="aide_index.php3?aide=logoart" TARGET="_top"><img src="AIDE/logoart-2.gif" alt=" "  border="0" align="right"></A>
1149
You can install a logo for each news item on your site. This logo could be unique (fixed image) or animated to manage mouse hovering.
1150
 
1151
The images installation for this news item logo is exactly the same as the installation of the <A HREF="aide_index.php3?aide=logoart" TARGET="_top">article's logo</A>.
1152
 
1153
</breveslogo>
1154
 
1155
<suiviforum>
1156
 
1157
{{{Forums follow-up}}}
1158
 
1159
The forums follow-up page is an important element of your site if you allow the use of public forums (on this matter, refer to the documentation about <A HREF="aide_index.php3?aide=confforums" TARGET="_top">public forums configuration</A>). It is here, in fact, that the forums moderation takes place.
1160
 
1161
- {{Messages display}}
1162
 
1163
Messages are not displayed here according to their hierarchical structure (by {threads}), but one after the other in a reverse chronological order (the most recent first). On the other hand, each message is accompanied by the name of the article it refers to.
1164
 
1165
- {{Deleting a message}}
1166
 
1167
The main feature here is the ability to {delete} contributions. {{Warning:}} this operation is irreversible. However, a deleted message is not removed from the database: it appears on this page surrounded by a red frame, accompanied by the date the message was received and the IP address of the sender.
1168
 
1169
- If you already configured public forums with the option of a {beforehand} moderation, messages in waiting are yellow framed and offer two buttons: {delete this message} and {validate this message}.
1170
 
1171
</suiviforum>
1172
 
1173
<cookie>
1174
 
1175
{{{The administration cookie}}}
1176
 
1177
Administrators can activate a cookie which triggers the display of additional information during the visit of the public site.
1178
 
1179
- {{Refresh this page}}
1180
 
1181
A button labelled &laquo;Refresh this page&raquo; will appear on all the pages of the public site. Because SPIP integrates a {cache} system, some modifications may not appear immediately online. (Pages displayed on the public site are not directly pulled out from the database: they are refreshed at regular intervals and stored in the cache.)
1182
 
1183
By {refreshing} a page, the administrator instigates the display of the page according to the elements stored in the database, without the need to wait for the next refresh of the cache.
1184
 
1185
- {{Modifying...}}
1186
 
1187
The pages of articles, sections and news contain a button labelled &laquo;Modify this article&raquo; (or &laquo;section&raquo;...). This button takes you directly from the public site to the page in the private area corresponding to this article (or section...). This button makes it easier then, for the correction of mistakes discovered online, or the update of any element of the site.
1188
 
1189
- {{Number of visits}}
1190
 
1191
If the statistical system integrated to SPIP is enabled, the following information is added to the articles pages: number of visits (estimate) and number of different {referrers}.
1192
 
1193
Referrers are links to this particular article from outside the site (that is, when a site offers a direct link to this article, or when this article's address was passed by e-mail).
1194
 
1195
- {{Connection identifier}}
1196
 
1197
The administration cookie also enables SPIP to recognise your browser when you connect again: you then just have to enter your password to be able to get access to the private area.
1198
 
1199
(PS: if the connection is cookie dependant - it is the most common situation -, this cookie is placed in the private area as soon as you reach it.)
1200
 
1201
</cookie>
1202
 
1203
<mots>
1204
 
1205
{{{Keywords}}}
1206
 
1207
One of SPIP's most important restrictions is its hierarchical structure: each article can belong to only one section, which could sometimes cause classification problems.
1208
 
1209
Keywords offer a way of cross navigation inside the site. By associating one or more keywords to an article, we have at our disposal a way to create links to other articles with similar topics but located in other sections.
1210
 
1211
Keywords do not offer much benefit unless each one is associated with several articles, in order to be able to link these different articles to each others.
1212
 
1213
{Only the administrators can create and modify keywords.}
1214
 
1215
{Frequently, the sections structure, if it is well built, can do without keywords: articles with the same topic are simply located in the same section, it is, therefore, pointless to add those keywords to indicate the topic of each one. Administrators can then, totally disable the use of keywords in the <A HREF="aide_index.php3?aide=confart" TARGET="_top">Precise configuration</A> page.
1216
 
1217
</mots>
1218
 
1219
<motsgroupes>
1220
 
1221
{{{Keywords groups}}}
1222
 
1223
When you use a lot of keywords, it becomes awkward to manage them efficiently. That is why you can create groups containing those keywords. The interface then, becomes neater (for instance, a &laquo;Countries&raquo; group could contain &laquo;Namibia&raquo;, &laquo;Germany&raquo;, &laquo;Peru&raquo; while a &laquo;Topics&raquo; group contains &laquo;Unemployment&raquo;, &laquo;Poetry&raquo;, &laquo;Animals&raquo;...).
1224
 
1225
</motsgroupes>
1226
 
1227
<messut>
1228
 
1229
{{{Messages between users}}}
1230
 
1231
SPIP makes it easy to exchange messages between users of the site, without going through e-mails.
1232
 
1233
When a message is &laquo;sent&raquo; by a user to one or several other users, it turns into a private discussion forum. That way, once a message is sent, a discussion can take place, in the shape of a forum located under this message. With SPIP, we can consider that a message is also a private forum (that is, there is no point in exchanging a large amount of messages to hold a discussion, you simply &laquo;remain&raquo; in the same message with your correspondent to "chat", thanks to the private forum associated with him).
1234
 
1235
{Note:} Messages between users and their associated forums are private, this means that SPIP does not offer any interface for the administrators to see those messages. However, bear in mind that this confidentiality is very relative: a site administrator armed with a direct access tool to the database, can always check these messages.
1236
 
1237
- {{Creating a message/discussion}}
1238
 
1239
The simplest way to send a message is to click on the green logo (a small &laquo;M&raquo; followed by a triangle) displayed next to the recipient name. This will immediately opens a new message.
1240
 
1241
The second way is to use the button labelled &laquo;New Message&raquo; which appears on every page in SPIP. This will open a new message without recipient. Before sending the message, you should, of course, specify the recipient.
1242
 
1243
The editing interface of these messages is very straightforward.
1244
 
1245
The only common error to avoid is to forget to &laquo;send&raquo; this message: as long as the message has the status &laquo;Editing in progress&raquo;, only its author can have access to it. It should then be sent in order for the recipients to see it (warning: once a message has been sent, it cannot be modified anymore).
1246
 
1247
- {{Adding/removing a recipient}}
1248
 
1249
At any moment in time, it is possible to add a recipient: either during the editing of the message or after it was sent (for instance, to add a new participant to a discussion in a forum which is interesting to him).
1250
 
1251
In the same way, you can remove a participant at any moment. Besides, a button labelled &laquo;Stop participation to this discussion&raquo; allows any participant to remove himself from a discussion.
1252
 
1253
- {{Making a appointment}}
1254
 
1255
Any message can be turned into a appointment: this means that it is linked to a date displayed in SPIP's calendar.
1256
 
1257
- {{Can we write to any user of the site?}}
1258
 
1259
Some editors could be unreachable (they do not show in the list &laquo;Add a participant&raquo; and their name is not accompanied by a messaging logo):
1260
- editors could decide individually, not to use the internal messaging system;
1261
- editors who did not connect to the private area for more than 15 days are unreachable (for these users who seldom connect, it is preferable to use ordinary e-mails).
1262
 
1263
</messut>
1264
 
1265
<messpense>
1266
 
1267
{{{Memos}}}
1268
 
1269
A memo (&laquo;memorandum&raquo; or &laquo;memory juggler&raquo;) is shaped like a message: but it does not require any recipient. Only its author can have access to it.
1270
 
1271
It is clear from its name that the memo aims at recording elements we would like to preserve.
1272
 
1273
- {{Inserting a memo in the calendar}}
1274
 
1275
The most practical use of the memo is to give it a date. That way, the memo acts as a reminder to its author until that date (and during the following 24 hours) and it appears in SPIP's calendar.
1276
 
1277
{Note:} As with messages between users, we attract your attention to the relative confidentiality of these memos. SPIP does not offer any interface for the administrators to see your messages. However, other direct access tools to the database, are capable of doing it.
1278
 
1279
</messpense>
1280
 
1281
<messcalen>
1282
 
1283
{{{The calendar}}}
1284
 
1285
SPIP's calendar offers two types of information:
1286
 
1287
- {{information common to the whole site;}} these are the published articles and news - That way, the calendar allows articles retrieval according to their date of online publication;
1288
 
1289
- {{private information;}} these are the messages between users and the memos endowed with an appointment date. This calendar then, can act as a reminder and a diary.
1290
 
1291
You should note that each calendar day is accompanied by a small blue logo: this logo allows the creation of a memo directly associated to that date (the time of the appointment can be adjusted more precisely thanks to the editing interface of this memo).
1292
 
1293
</messcalen>
1294
 
1295
<messconf>
1296
 
1297
{{{Messaging customisation}}}
1298
 
1299
Each user can customise the configuration of internal messaging.
1300
 
1301
{Note:} Site administrators can decide not to use the messaging system or the list of connected users. Anyway, if an option is disabled globally for the whole site (by an administrator), editors cannot have access to it.
1302
 
1303
- {{Do not use internal messaging}}
1304
 
1305
If internal messaging is available for the whole site (option reserved for administrators), each user can take an individual decision not to use it (That is, he simply does not wish to exchange messages with other users through this system).
1306
 
1307
- {{Do not use the list of connected users}}
1308
 
1309
When this feature is available (by the administrators choice), and while he is using internal messaging, an editor can take an individual decision not to participate to the list of connected users.
1310
 
1311
This feature continuously displays the list of connected users in real time, which makes it easy for users to take part in quick discussions. Some users may find this feature intrusive and/or may not wish to be &laquo;disturbed&raquo; when they connect. They just have to disable this option: they will not appear on the list of connected editors anymore, and this list will no longer show on their pages.
1312
 
1313
{Note:} When an administrator indicates that he does not wish to appear on the list of connected editors, the list still shows: he &laquo;sees&raquo; the others, but the others do not &laquo;see&raquo; him.
1314
 
1315
</messconf>
1316
 
1317
<reference>
1318
 
1319
{{{Referenced sites}}}
1320
 
1321
SPIP offers a complete management system for lists of links to other sites. This system is very comprehensive and offers particularly:
1322
- grouping of these lists in sections (same sections containing articles or specific sections dedicated to this use, in the same way as a links directory);
1323
- associating a logo with each site;
1324
- associating keywords with each referenced site;
1325
- adding a customised description to each site.
1326
 
1327
Furthermore, and for the sites that permit it, you can automatically fetch the latest articles published (refer to &laquo;<a href="aide_index.php3?aide=rubsyn" target="_top">Syndicated sites</a>&raquo;).
1328
 
1329
{{Referencing a new site}}
1330
 
1331
A button labelled &laquo;Reference a new site&raquo; in every section page in your site allows you to add a new site.
1332
 
1333
The &laquo;traditional&raquo; way is to indicate the site's name and its URL, then to insert a description. It is also possible to select the section of your site in which this referencing is to be inserted.
1334
 
1335
A box at the bottom of the page allows you to manage any possible syndication of the content. For more details on this matter refer to the explanation of  <a href="aide_index.php3?aide=rubsyn "target="_top">syndicated sites</a>. For a straightforward referencing, you just select the option &laquo;no syndication&raquo;.
1336
 
1337
{{Quick referencing}}
1338
 
1339
During the creation of a new site referencing, a box appears at the top of the page to offer you a quick referencing of a site without the need to enter its name or description. For this, you just have to enter the URL of the page you wish to reference and to submit. As far as possible, SPIP will go to this address and try to automatically fetch the page title and a description. You can modify this information at a later time.
1340
 
1341
{{Who can suggest referenced sites?}}
1342
 
1343
In the &laquo;Precise configuration&raquo; page, administrators can specify that only administrators have the possibility to suggest sites, or the editors or even the site visitors (in the last case, a form on the public site will give the visitors the opportunity to suggest sites).
1344
 
1345
Anyway, only the administrators can validate these referencing suggestions. When a site referencing is suggested, all the participants to the private area can discuss the relevance of the suggestion in a forum linked to each site.
1346
 
1347
</reference>
1348
 
1349
<artsyn>
1350
 
1351
{{{Syndicated articles}}}
1352
 
1353
When you request a <A HREF="aide_index.php3?aide=rubsyn" TARGET="_top">site syndication</A>, SPIP displays a list of the latest articles published on this site, under the label &laquo;Syndicated articles pulled out from this site&raquo;.
1354
 
1355
For each article, SPIP displays:
1356
- the article's title (you just click on this title to access the article on its original site);
1357
- the article's authors, should there be any;
1358
- the article's description, should there be one.
1359
 
1360
This information, pulled automatically out of the referenced site, cannot be modified.
1361
 
1362
Furthermore, for each article, a button labelled &laquo;block this link&raquo; allows you to block its display on your own site (because the article does not suit you or there is an error disabling this link...). You can restore the display of this article on your site at any time.
1363
 
1364
It is also possible to request that each future link coming from the site should be blocked beforehand. The articles pulled out will not be displayed unless you validate each one of them &laquo;manually&raquo;.
1365
 
1366
</artsyn>
1367
 
1368
<confhttpproxy>
1369
 
1370
{{{Using a HTTP proxy}}}
1371
 
1372
If your site is behind a firewall, you could find that you have to configure a HTTP proxy to be able to fetch the new syndicated sites over the internet.
1373
 
1374
This proxy should allow outgoing requests without any authentication.
1375
 
1376
In your site configuration (in the section labelled &laquo;SPIP features&raquo;), enter the proxy in the following format:
1377
 
1378
<code>http://proxyname:port/</code>
1379
 
1380
where {proxyname} is the name of the server acting as a proxy, and {port} is the number of the TCP port (most frequently 3128, 8080, or even 80) which will handle the requests.
1381
 
1382
Warning: This set-up is global: SPIP will fetch all the syndicated sites through this proxy. If you need more precise settings, you must contact your network administrator.
1383
 
1384
</confhttpproxy>
1385
 
1386
<deconnect>
1387
 
1388
{{{Disconnecting}}}
1389
 
1390
You can click on the button &laquo;Disconnect&raquo; to cancel your identification in the private area. When you click on it the login information that you entered to access the private area are &laquo;lost&raquo; by the system; SPIP will ask you to re-enter this information or to go back to the public site.
1391
 
1392
{The main benefit of this feature is to deny to another person using your machine any access to the private area by taking advantage of your own login information.}
1393
 
1394
- {{You are working on your own and you are the only one having access to the computer}}
1395
 
1396
In this case, it may seem that disconnecting through this feature is somewhat superfluous. Disconnecting is of course recommended, but there is not much harm if you forget.
1397
 
1398
- {{You access the private area with a multi-user machine}}
1399
 
1400
In this case, it is strongly advised that you disconnect systematically through this feature when you finish your work. This will completely deny any access to the private area to any person other than you who is using the same machine.
1401
 
1402
- {{Using several identifiers for the same site}}
1403
 
1404
Some users would like to access the private area with more than one identity. In this case, they can use the disconnect feature to exit then connect again under new identifiers.
1405
 
1406
</deconnect>
1407
 
1408
<spip>
1409
 
1410
</spip>