{{{A template problem}}}
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).
The problem could result:
- either from an error in the definition of your template, if you are in the process of modifying your site;
- or from a failure in the database.
For instance, a message of the sort
_ > Unknown column 'articles.chapi' in 'where clause'
indicates that the loop calls a selection criteria (chapi
) which is not accounted for.
От друга страна, едно съобщение от типа
_ > Файлът не може да бъде отворен: 'spip_articles.MYD'
показва сериозен проблем в базата данни MySQL: в такъв случай трябва да се свържете с доставчика си, за ва одобри инсталацията и/или да поправи базата Ви данни.Ако имате нова версия на MySQL (поне 3.23.14), можете също така да опитате автоматична поправка на базата данни.
{{{Удостоверяване чрез FTP}}}
Някои от възможностите на СПИП имат пряко влияние върху структурата и съдържанието на базата данни (най-вече: актуализации, архивиране и възстановяване на базата данни и др.). За тези много особени свойства е създадена процедура за FTP идентификация, за да се ограничи тяхното използване до ограничен брой потребители, които имат достъп до сървъра на сайта посредством FTP (по-общо, ако един сайт позволява няколко администратори на СПИП, достъпът до FTP е ограничен до главният уеб администратор).
To be able to use these features, you have to simultaneously:
- connect to the web with your usual browser; when you launch the action, SPIP specifies a name of the format «admin_{xxxxx}», that you must write down;
- свържете се с Вашия сървър на сайта посредством FTP; в папката /ecrire/data, създайте файл (или празна директория) и я наречете «admin_{xxxxx}»;
- След като създадете файла или директорията, върнете се към интернет навигатора си и презаредете страницата, която заключава идентификацията на FTP и ускорява действитето.
{{{Authors}}}
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...)
- {{Adding an author}}
A drop-down menu showing the list of all the site editors allows selecting and adding a new author.
{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 «search». If the search returns more than one author, the system will let you select the one you want.}
- {{Removing an author}}
Next to each author of the article, the link «Remove the author» allows you to simply remove this author.
{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.}
- {{Replacing an author by another}}
This can be achieved in two steps: simply add the new author and remove the first one (see above).
- 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.
{{{The deck}}}
In the publishing jargon, the {deck} is the short text (cap) that «covers» the article. It is optional.
Administrators can, via the page «Precise configuration », disable completely the use of the deck.
{{{Article redirection}}}
This option allows you to create a «Virtual Article»: it is an article which has its title, date and authors recorded in your site under SPIP, but which points to another URL.
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).
To signal that your article is a «Virtual Article», you just have to enter the URL of the target article in the corresponding box.
To remove the redirection, you simply «empty» the redirection box (delete the URL of the target article).
{{{Date of online publishing}}}
Generally, the article's {date} corresponds to the date of its {online appearance} (or publication on the web site).
- 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).
- However, after validating the article, the administrator can still modify this date.
{{{Date of earlier publication}}}
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.
Това дава възможност да определите даден документ като обект на предишна публикация: статия от вестник, книга и др.
- by default , this date is not displayed: the option «Hide date of earlier publication» is selected at the time of the creation of the article.
- If you want to specify such a date, you must select the option «Show date of earlier publication» as well as use the drop-down menus to set it up.
Unlike the «publication date» 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.
{The site administrators can disable the use of the earlier publication date in the «precise Configuration» section.}
{{{Brief description}}}
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.
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.)
{The site administrators can completely disable the display of the description in the «precise Configuration» section.}
{{{Вмъкване на изображения в текста}}}
СПИП предлага възможност да се илюстрират статиите и новините с изображения. Това може да се постигне с няколко действия: трябва да изпратите файла с изображението на сайта, след това да го добавите в текста.
-------
Preparing: {{Images formats}}
When you create your images (with your usual application), you must save them in one of the following formats:
- GIF; (extension {{.gif}})
- JPEG; (extension {{.jpg}})
- PNG (extension {{.png}}).
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.
------
Step 1: {{Installing the images on the server}}
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.
Когато "променяте" статия или новина, лявата колона показва форма, наречена: "Добавяне на
изображение". Тя се превръща в {текстово поле}, последвано от бутон, наречен (в зависимост от версията на Вашия интернет навигатор) "Търсене", "Избиране", "Файл" и т.н.
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.
Having done this, click on the button called: «Upload».
If the operation succeeds, your image will appear in the left column, accompanied by several settings...
-------
Step 2: {{information concerning your image}}
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 «unfold» the information box).
{image size.} Just above the image, the width and height of your image (in pixels) are displayed.
- {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.
- {SPIP shortcuts}. see below: SPIP will remind you of the 3 «shortcuts», which enable you to insert this image within your text. It is worth noting that every image is «numbered» thus: «IMG1», «IMG2»... These «shortcuts» are used in the third step.
- {Image size}. Just above the image, its width and height (in pixels) are displayed.
- { 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...
- {Delete this image}. As you can guess, «Delete this image» 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.
Можете да повторите операцията с колкото изображения пожелаете (една статия или новина може да съдържа множество изображения).
-------
Step 3: {{Inserting an image inside the text}}
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 «shortcut» enabling the insertion of your image easily.
- {Images without caption}
For each image, look at the 3 shortcuts:
- <IMG1|left>
- <img1|center>
- <IMG1|right>
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 «Text», at the location you want the image to appear. «left» aligns the image to the left, «right» to the right and «center» centres your image in the text.
When the page is displayed, SPIP will replace these shortcuts by the corresponding HTML tags by automatically calculating the dimensions of the images.
- {Images with title and description}
If you entered a title and/or a description, the code <img...> is replaced with:
- <doc1|left>
- <doc1|center>
- <doc1|right>
These shortcuts are used in the same way as above; however, when you insert such a «shortcut», 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.
{{{Attaching multimedia documents}}}
The SPIP interface allows you to integrate multimedia files to your site (sound, video, text,...).
Editors can attach documents to articles. These documents can be located either at the end of the text (a bit like «attachements»), or inside the text as a preview vignette (or thumbnail).
Site administrators can also install documents directly in the sections.
Трябва да забележите важната разлика между двата начина: в статиите документите са "приложения" и те са безполезни без самите статии (когато разглеждате сайта, можете да достигнете до тези файлове само през статиите); когато те се поставят направо в рубрикитие, документите сами стават елементи на сайта каквито са статиите и новините, а не допълваща информация.
--------
Step 1: {{Installing the documents on the server}}
The files installation on the server is performed through the interface «Attach document» for the articles and «Publish a document in this section» for the sections.
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.
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, }«xxxxxx.mp3»{ for an MP3 file.})
Интерфейсът е същия, като този, за изображенията: бутонът "Файл" или "Търсене" (в зависимост от навигатора) отваря прозарец, който позволява да се избере файл от диска. След като изберете желания файл, натискате "Качване", за да го изпратите на сървъра. {Предупреждение: тази операция може да отнеме доста време, в зависимост от размера на файла. Забележете също така, че в зависимост от настройките на Вашия доставчик, големите файлове могат да бъдат отхвърлени; в такива случаи трябва да заобиколите ограничението чрез Инсталиране на файлове чрез FTP.}
---------
Step 2: {{Information and vignette}}
Once the file has been transferred to the server, an information box appears. Several operations can be performed therein.
- {Preview vignette}
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.
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}.
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.
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 «Delete the customised vignette» link allows you to go back to the default vignette if necessary.
- In the article modification page, the «shortcuts» allowing you to insert a document in the text are identical to the images ones.
- 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.
- Finally, the button «Delete this document» deletes the unnecessary files. {You should note that it is imperative to delete unwanted documents, otherwise they would appear on the public site.}
- {{Относно документите, добавени в рубриките,}} можете също да променяте датата на публикацията им (на същия принцип за променяне при статиите и новините). Веднъж като се изпратят настройките, документите в рубриката стават незабавно видими на публичния сайт (при тях не е нужно да се дава одобрение като при новините и статиите.
---------
Step 3: {{Insert documents in articles text}}
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}.
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.
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 <imgxx|yy> or <docxx|yy> whether you want to display the vignette alone or with its title and description.
{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 «Attached documents».
----------
Special case: {{Video and sound documents}}
Some multimedia files are meant to be displayed directly on a web page (for instance, a video clip inserted directly in the article).
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).
{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).
Once you have entered these dimensions, an additional SPIP shortcut will be provided, in the shape of <embxx|yy> (as a reminder «{{emb}}ed»).
If you are very familiar with this sort of integration, you will be happy to know that you can add additional parameters such as:
{{{Инсталиране на файлове чрез FTP}}}
Някои сървъри не позволяват качването на файлове през уеб-интерфейс. Следователно, може да е много тромаво да се изпращат големи файлове по този начин. СПИП позволява да се преминат тези ограничения чрез инсталиране на файлове, използвани за изображения и документи чрез FTP.
Разбира се, тази операция е ограничена за потребители, които притежават кода за връзка към сървър FTP.
- {{The folder /ecrire/upload}}
С Вашия FTP клиент, трябва само да качите файловете си (изображения, мултимедия, документи) в папката /ecrire/upload на Вашия сайт под СПИП.
- {{The files drop-down menu}}
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.
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.
- {{All the files at once}}
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.
{{{Article in current editing}}}
When an editor opens an article to edit it, other participants visiting the page are notified and advised not to edit the article themselves.
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.
If you see the notice «Warning, an editor intervened on this article», 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.
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 «release» this article. The warning shown to the others will disappear which enables them to enter their modifications if necessary.
{{{Keywords}}}
С цел да се разнообрази разглеждането на сайта, възможно е да се добавят Ключови думи към статиите, новините и свързаните сайтове. По този начин не само посетителите ще могат да търсят от рубрика в рубрика, но също и от статия на дадена тематика (означена с ключова дума) към друга статия, свързана със същата ключова дума.
За всяка статия, новина или сайт можете да определите толкова ключови думи, колкото пожелаете.
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 «Search».}
{{P.S.}} Only the administrators can create keywords from within the page dedicated to their management (the «Keywords» button in the top navigation bar).
{Administrators can disable the use of keywords for the whole site in the «precise Configuration» section.}
{{{Submitting an article}}}
While an article is in progress (see the section «Article status»), it displays a button «asking for the publication of this article».
{Only the article's author is allowed to perform this operation.}
This means that the article is «submitted for evaluation», 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.
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 «editing in progress» mode.
Consequently, the operation «Ask for the publication of this article» 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 «editing in progress» mode.
{{{Selecting the section}}}
The menu shows the complete sections hierarchy (in the order in which they where created by the site administrators): select the section in which you want to place your article.
A lot of novice users seem to be oblivious to this feature though very simple, and drop their article «anywhere» in the site structure. Consequently, the administrators are advised to always check if an article is in the right section before validating it.
{{{Article status}}}
The article {status} concerns its editorial situation in the site. the article can take the following states:
- editing in progress;
- submitted for evaluation;
- published online;
- to the dustbin;
- rejected.
These states, that only the administrators can modify, enable the site management.
{{P.S.}} the articles status is symbolised by coloured bullets.
{{editing in progress}}
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 ...
{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.}
{{Submitted for evaluation}}
When the author considers that his article is ready, he «suggests» it to the other participants, so that it could possibly be discussed collectively, before being validated (published online) or rejected.
{When the article is «submitted for evaluation», it appears in the «Launch pad» 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.
Such an article is then visible to all editors. On the other hand, it can only be modified by its author or an administrator.}
{{Published online}}
After being possibly discussed by the editors (during the submission stage), an article could be «validated», that is, published online by an administrator. By then, it is available to all the visitors of the public site.
{Once an article has been published online, only
administrators can modify it. Its author - unless also an administrator - can no longer modify it,
but has to go through an administrator to make any corrections.}
{{Rejected}}
A «submitted» article, which does not conform to the editorial line of the site, can be «rejected» if the administrators refuse to publish it online.
{A «rejected» article becomes visible only to its author and to the administrators.}
{However, a «rejected» 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 «editing in progress» status instead of just «reject» it, in order for its author to be able to modify it and re-submit it later.}
{{To the dustbin}}
An article can be sent «to the dustbin» only by an administrator.
{An article sent «to the dustbin» is not visible anymore in the private area, even for the administrators. Be careful then, this option is «radical»: the article disappears completely.
In fact, the article is still saved in the database, but becomes extremely difficult to reach with the tools provided by SPIP.}
Therefore, this option is reserved to articles created by mistake, and destined to be totally removed. Often then, it is advised to choose the «rejected» option instead because it is less dramatic.
- 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 «editing» mode. However, once an article is published online, do not overdo these changes of status: you will end up with a site «full of holes», with appearing and disappearing pages, which is very penalising for the visitor.
{{{The article's text}}}
Pretty straightforward: this is the {text} of your article as its name suggests.
- 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.
- Текстът на статията е много добре нагоден да се използав с типографските кратки команди
{{{Title, top title, subtitle}}}
- The {title} is compulsory.
- 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.
{Should they wish so, the administrators can disable the use of the top title and/or the subtitle in the «precise Configuration» section.}
{{{Articles content}}}
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.
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 «precise configuration» page allows to disable completely the use of these elements.
{{P.S.}} It is important to understand that, with regard to the choice of {simplified interface / complete interface}, which only influences the interface of each user, the choice of the options of the «Precise configuration» 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.
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.
{{{Включване/изключване на системата за новини}}}
Някои сайтове на използват {новини}, т.е. кратки статии без автор. Вероятно администраторът не ги е включил в дизайна на публичния сайт.
In this case, you can simply decide to disable them. So the editors cannot create them. The interface will be all the less burdened.
{{{Automated e-mailing}}}
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...
Предупреждение: някои доставчици забраняват свойството "автоматично изпращане на електронно писмо". Ако ситуацията е такава, следващите опции не могат да бъдат активирани.
- {{Follow-up of public forum messages}}
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.
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.
- {{ Follow-up of editorial activity}}
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.
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.
- {{Известия за новини}}
Свойството, предложено от СПИП, предлага създаване на електронни съобщения от типа "Най-скорошни новини": ако го активирате и укажете забавянето между известията, ще бъде изпращано регулярно писмо по електронната поща до посочен адрес с резюме на най-скоро публикуваните статии и новини.
Това свойство е много лесно за изпълнение: ако активирте опцията чрез указване на забавяне от 7 дни, един път на 7 дни, СПИП ще изпраща списък със статиите и новините, публикувани пред тези 7 дни на посочения адрес.
A «Send now» 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).
Можете да изпращате известието за най-скорошни новини на адреса на главния администратор (който ще го препраща) или, ако харесвате сайтовете със самостоятелно управление, можете да изпращате съобщението до списък от абонати (СПИП не предлага възможност за използване на пощенски списъци).
{{{Publication of post-dated articles}}}
It is possible for administrators to modify an article's date of online publication (when this article is declared as «published online»).
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 «31st of May 2002» 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?
- 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 «published online», 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 «new» articles despite the absence of their author.
- 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.
{{{Internal messaging}}}
SPIP offers an internal messaging system (a section of the present documentation is dedicated to the messages between users, to the memos and to the calendar).
You can decide to use all or parts of this system.
- {{ Enabling/disabling internal messaging}}
Една от причините, за да не се използва системата за изпращане на вътрешни съобщения може да бъде мястото, което съобщенията ще заемат в базата данни: те (както и съобщенията от форума, свързан към Вашата статия например) се пазят в базата данни и следователно заемат дисково пространсво у доставчика. Освен това, свойствата на системата за изпращане на вътрешни съобщения са в допълнителна тежест на машината, която побира сайта: в случай на машина със слаба (и/или много бавна) спецификация, по-добре е да олекотите задачите и да забраните изпращането на съобщения.
- {{Enabling/disabling the list of connected editors}}
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.
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.
{You should note that:} When you enable the above features for the whole site, it is still possible, for every user, to disable these features for his own use. This way, if a user finds the internal messaging functions unnecessary or intrusive, he can simply disable this feature for his own use.
{{{Operation of public forums}}}
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.
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}).
- {{Disabling public forums}}
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).
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).
- {{Afterwards moderated forums}}
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.}
- {{Beforhand moderated forums}}
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.
- {{Forums accessed by subscription}}
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.
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).
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 «by subscription» mode, you can have access to the «file» (extremely small) of the author of this contribution. You can simply send this author «to the dustbin»: his identification will not work anymore and he will not be able to obtain a new one with the same e-mail address.
Предупреждение: формата "форум чрез абониране" изисква доставчикът Ви да поддържа автоматично изпращане на електронни писма. Ако той не поддържа това, сменете доставчика си ;)
{{{Enabling/disabling the search engine}}}
СПИП има вградена търсеща машина. Когато тя е включена, система за индексиране на статии анализира съдържаниета на всички статии. Тази операция, въпреки че предлага допълнителни много бързи условия за търсене, изисква много усилия за сървъра, на който се помещава сайта. В случай, че доставчикът е бавен, това може да породи проблеми.
For this reason, you can enable or disable the system indexing.
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).
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 ht://Dig.
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.
{{{Name and URL of your site}}}
The name and URL of your site are, in particular, used to generate the file «backend.php3» which allows the syndication of your site (i.e. display the last 10 articles published by your site in another site).
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 «/». If your homepage address is:
http://www.mysite.net/index.html,
Your site's URL should be written thus:
http://www.mysite.net/
{{{Visits statistics}}}
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.
- {{Number of visits}}
Every day, SPIP identifies «unique visitors» 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 «hits» or «watched pages»; a visitor coming back several times to the same page is counted as a unique «unique visitor»).
- {{Direct visits or referrers}}
A «direct visit» 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 «referrer»).
For the entire site and for each article, SPIP displays the list of the main «referrers» (the pages displaying a hypertext link to your site), accompanied by the number of «direct visits» (the number of visitors who followed this link).
-----
- {{A «relatively» reliable system}}
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 «unique visitors» is based on the visitors IP address every day, which is not the most precise method, we think, however, that it provides a «relatively» reliable information.
If you want a thorough information of your site's traffic, you could use another system more specialised in statistical analysis.
- {{A daily calculation}}
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).
- {{Enabling/disabling statistics and referrers}}
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.
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).
- {{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.
{{{Предварително: поставяне на разрешения}}}
Когато инсталирате СПИП файлове на сървъра чрез FTP, някои {{директории}} няма да бъдат конфигурирани правилно: следователно, трябва да промените конфигурацията им през обичайния си FTP клиент.
Променете "разрешенията" на следните директории:
- {{/CACHE}}
- {{/IMG}}
- {{/ecrire}}
- {{/ecrire/data}}
FTP клиентите се различават по функции, но процедурата е най-общо следната:
- изберете папката, на която желаете да промените "разрешенията";
- намерете във Вашия FTP клиент свойство, наречено "{смяна} или {промяна} или {настройка} на разрешения;
- If this feature appears as a graphical interface, check the box corresponding to «Write» for the «Others» (or «World» or «All users»):
- If this feature appears in «text» mode, the numeric configuration is «777».
When you make this modification for every directory indicated by the installation system, you must reload the page and the procedure resumes automatically.
{{{Your MySQL connection}}}
This step consists of entering the necessary information for the connection of SPIP to MySQL server.
- {Адрес на базата данни:} в зависимост от това, кой доставчик сте избрали, тази информация ще бъде просто "местен доставчик (localhost), или адреса на Вашия сайт («www.moia_site.org»).
- {Потребителско име на връзката:} често е същото потребителско име, което използвате за да качвате файлове чрез FTP.
- {Парола на връзката:} често е същата парола, която използвате за достъп до FTP сайта.
- Настройките не могат да бъдат измислени: ако не ги знаете, значи, че доставчикът Ви не Ви ги е дал. Следвателно => ако нямате тази информация под ръка, няма как да продължите!
- Настройките Ви се дават от {{доставчика на Вашия сайт}}: за да ги получите, свържете се направо с него (не е нужно да ги искате от екипа за разработка на СПИП, защото ние не ги знаем!). Някои доставчици имат написана тази информация на сайтовете си под формата на наръчник.
- Трябва да забележите, че много често се налага да {{искате}} от доставчика си да активира достъпа Ви до MySQL или да изпълнявате тази специфична процедура сами. Някои доставчици, които твърдят, че предоставят поддръжка за базата данни MySQL, не активират автоматично връзката, когато настройват за първи път сайта да работи. Необходимо е допълнително да го помолите за това (след като откриете име за достъп до доставчика). В този случай, отнесете се към документацията, предоставена Ви от доставчика, за да узнаете как да {активирате} връзката си до MySQL. (Отново, екипът на СПИП не може да помогне за това).
{{{Choosing your database}}}
- Трябва да изберете {име} на базата данни, която Ви е отдадена от доставчика. Тази информация е осигурена от доставчика: ако нямате такава, обърнете се към него или към документацията, публикувана в интерене (няма нужда в случая да се обръщате към екипа за разработване на СПИП, защото ние я нямаме).
- Много често, тази информация отговаря на {потребителското име} за входа за доставчика (тази, която използвате, за да се свържете със сайта си чрез FTP).
- Първа възможност (по-често срещана): списъкът с имена за достъп е показан (понякога е доста дълъг, в зависимост от конфигурацията, който доставчикът е задал). Измежду имената има само едно, което отговаря на Вашето; просто го изберете и го одобрете, за да може да преминете на следващия етап.
- Втора възможност: само едно име за достъп, отговарящо на Вашето, е показано (доставчикът Ви автоматично е конфигурирал системата да показва само Вашето име). Лесно: изберете името и го одобрете.
- 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 «create a new database».
- Последна възможност (грешка): Вашето име за достъп не се появява в списъка и не можете да създадете такова. Това е рядък случай: означава, че Вашият доставчик е създал достъп за Вас до сървъра с базата данни, но е забравил да Ви създаде име за достъп. В този случай трябва да се свържете направо с него.
{{{Personal information}}}
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...
Note that once your site is installed, you will have the possibility to change this information.
- {Your public identity:} that is what will appear as a signature of your articles.
- {Идентификация на интернет връзката:} това е идентификация, която {{Вие сам(а) избирате}}, за да се свържете с Вашата СПИП система. Тази информация не е нужно да е същата, която доставчикът Ви е предоставил за връзка с FTP сървъра. Обратното, {по-добре НЕ ИЗПОЛЗВАЮТЕ същите потребителско име и парола} за достъпа до СПИП (който можете свободно да изберете), за разлика от връзката с FTP (която Ви е указана от доставчика).
{{{Simplified interface / complete interface}}}
Each SPIP user can modify his own display (without affecting the display for the other users, contrary to the «Precise configuration» page).
Several SPIP features are very rarely used (or not at all) by some editors. Therefore, choosing the «simplified interface» 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 «date of earlier publication» which does not appear in the «simplified interface» mode.
{{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.
{For these modifications to take effect, you must accept the use of cookies.}
{{{Article's logo}}}
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.
For an article, it is possible:
- not to use any logo;
- to install a simple graphical logo;
- to use an animated logo that supports «hovering» (a logo with «2 positions»: the logo changes when the mouse hovers over it).
- {{Images formats}}
When you create your images (with your usual application), you must save them in one of the following formats:
- GIF (the GIF file could be an «animated GIF»);
- JPEG;
- PNG (we advise against it because several browsers do not support it correctly).
{In order to avoid serious operating errors, SPIP rejects image files bigger than 256 KB.} Advice: because these «buttons» 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.
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}.
{If you create a button which supports «hovering», create two different graphic files (one for the «normal» 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).}
- {{Simple logo}} (no hovering)
To add a button, a box is provided in the left column of the article, under the title «ARTICLE'S LOGO».
Depending on your browser version, click on the button «Browse», «Select», «File»...which opens a dialogue box allowing to select the graphic file corresponding to your button from your hard drive.
Once the file is selected, click on the button «Upload». Et voilà...! your button appears. It is followed by a button «Delete logo» that simply offers you to delete this logo.
If you do not plan to use a hovering logo, no more steps are needed.
- {{Replacing the logo}}
You could wish to replace the logo with another file. This is achieved in two steps:
- start by «Deleting the logo»: the previous box, containing the «Upload» button reappears;
- upload the new file, according to the procedure already described.
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 «cache»). Click on this image (with the right button of your mouse, or while pressing the «ctrl» key on the Macintosh) to show a contextual drop-down menu: select the option «Reload image». The new version of your logo will then appear.
- {{Logo for hovering}}
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 «HOVERING LOGO». It is in this box that you can select the second file aimed at the management of hovering.
{If, after installing both files, you delete the first one (the «simple» button), the box of the second logo disappears. Indeed, in the absence of the first logo, there is no point in managing any hovering!}
No intervention in the «text» 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.
{{To make the layout of the documents published by
SPIP easier, the system offers a number of «SPIP shortcuts» which:
- simplify matters for users who do not know HTML;
- make it possible for page layout to be processed automatically.}}
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.}}
~
{{{Прости типографски кратки команди в СПИП}}}
To start with, we present the simplest and most common shortcuts. For the users who wish to have more control over the layout of their texts, we shall further present more complex versions of these shortcuts.
{N.B.} The simple shortcuts fairly fulfill most needs, and make online publication almost as easy as writing an email.
- {{Typographie française automatique}}
SPIP respecte automatiquement les principales règles
d'espacement de la typographie française - ainsi des espaces
insécables sont ajoutées devant les caractères
«:», «;», «!», «?»~-,
et place des espaces insécables avant et après les
guillemets «à la française».
(Note: cette fonctionnalité n'est activée que sur les sites
dont la langue principale est le français.)
- {{Creating paragraphs}}
To create paragraphs, you simply leave a blank line, a bit like separating paragraphs in a e-mail (by «skipping» a line).
The simple «line feed» (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).
You can leave several consecutive blank lines
without any effect on the layout.
- {{Creating bulleted or numbered lists}}
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 («-»).
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 beginning with a dash, then a blank line will appear before the list
For example, - I like work;
- it fascinates me.
- I can sit and look at it for hours.
(Jerome K. Jerome)
will display:
- I like work;
- it fascinates me.
- I can sit and look at it for hours.
(Jerome K. Jerome)
{{Bold and italic}}
You specify a text in {italic} by placing it between simple braces: «...some text {in italic} in...».
You specify a text in {{bold}} by placing it between double braces: «...some text {{in bold}} in...».
- {{Paragraph headings}}
Paragraph headings are titles inside a
text that show its structure. In SPIP, they are
very simply defined by placing them between
treble braces: «{{{Section heading}}}» will display the heading, bold and centred:
{{{Section heading}}}
- {{Horizontal rule}}
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:
----
returns:
----
----
- {{Hypertext links}}
You can easily create a hypertext link with the following code:
SPIP is an initiative of the [minirezo->http://www.minirezo.net/].
which becomes
SPIP is an initiative of the [minirezo->http://www.minirezo.net/].
(To help remember: the dash followed by the greater-than sign makes a kind of arrow, showing that the link's text (before the arrow) "points to" an address.)
Адресът на препратката може да бъде абсолютен (започващ както в примера с http://
), относителен (препратка към друга страница от същия сайт), препратка към документ, който използва интернет протокол (ftp://
...) или електронен адрес («[->mailto:minirezo@rezo.net]
»).
Specific application: when nothing is entered before the "arrow", the text of the passed URL is displayed as a clickable link
. For example:
[->http://dmoz.org/World/Deutsch/Kultur/Literatur/Autoren_und_Autorinnen/P/Proust,_Marcel/]
returns:
[->http://dmoz.org/World/Deutsch/Kultur/Literatur/Autoren_und_Autorinnen/P/Proust,_Marcel/]
Remember that in the case of very long URLs, the display is truncated (in order to avoid the degradation of
your graphic interface), but the hypertext link points to the correct address.
- {{Hypertext links inside the site}}
По-нататък, същата тази система за хипертекстови препратки улеснява създаването на препратки вътре в сайта, работещ под СПИП. Единствената особеност се състои в намирането на {номера} на статията, рубриката или новината, към който желаете да насочите препратката:
Когато "посетите" някоя статия, новина или рубрика в личната зона, в лявата колона има поле, указващо този номер с големи цифри.
This is the number that you should insert in the hypertext link:
-* Link to article 342 (4 possibilities):}
link to [article->342]
link to [article->art342]
link to [article->article 342]
A particular use: [->art342] (no text before the "arrow") will automatically
display the title of article 342 with a link to that article.
-* Link to section 12:}
link to [section->rub12]
link to [section->rubrique 12]
-* препратка до новина 65:}
препратка до [новина->br65]
препратка до [новина->breve 65]
препратка до [новина->brève 65]
-* Authors, keywords, sites, im ages, documents:}
link to [an author->aut13] or [the same author->auteur13]
link to [a keyword->mot32]
link to [a syndicated site->site1]
link to [an attached document->doc17] or [the same document->document17]
link to [an image->img13] or [the same image->image13]
Specific application: here too, we can put nothing before the "arrow"
([->aut13]...).
SPIP will insert automatically the required information. In the case of an attached document or an image, if we manually entered a title, this title will be displayed ; otherwise, the file name itself is used.
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 [?expression]
in your text. That way, you can enrich your text with references without having to enter a web address!
So the following code:
"{Mansfield Park} is a major work by [?Jane Austen]
".
displays thus:
"{Mansfield Park} is a major work by [?Jane Austen]".
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.
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.
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.
- {{Footnotes}}
A footnote is usually indicated by a number inserted in the text then repeated at the bottom of the page and offering additional information.
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.
In SPIP, a footnote is placed between double brackets: « A[[Here is additional information.]] footnote.» will be displayed as: «A[[Here is additional information.]] footnote.»
- {{Quoting an excerpt (from the forum)}}
It is often practical, in a discussion forum, to quote an excerpt from the message which
we are replying to. To make the presentation of such quotes consistent, SPIP offers the shortcut
...
.
For example:
Pretty good that SPIP.
Right you are, rubber duck :-)
gives:
Pretty good that SPIP.
Right you are, rubber duck :-)
{{{More complete features}}}
The following shortcuts provide
more advanced functionalities, intended for a more specific use.
If this is your first experience with the shortcuts of SPIP, it is probably useless
to try and memorize them at this stage. You only need to now they exist; once
you really need them, come back to this page, it will then be much easier
for you to memorize shortcuts that you really need.
- {{Tables}}
To create simple tables in SPIP, you just have to create lines with «cells» separated by the symbol «|» ({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.
For example, the table:
| {{Surname}} | {{Forename}} | {{Age}} |
| Smith | John | 23 years |
| Captain | | not known |
| Bloggs | Philip | 46 years |
| Cadoc | Baby | 4 months |
is coded thus:
| {{Surname}} | {{Forename}} | {{Age}} |
| Smith | John | 23 years |
| Captain | | not known |
| Bloggs | Philip | 46 years |
| Cadoc | Baby | 4 months |
Note that all the entries of the first row appear in bold. SPIP identifies, thus,
that it is the row containing the columns headings and applies to it a presentation different from the other rows (different
background colour). The presence of such a row is not mandatory.
- {{Advanced management of lists and enumerations}}
- A sipmle carriage return can be performed by typing _
(the underscore symbol) at the beginning of the line, followed by a blank space.
{N.B.} In traditional typography, use of a "new line" by itself is very rare (restricted, more or less, to poetry). It is often confused with a new paragraph as found in printed documents (with no additional vertical spacing between the paragraphs). Web browsers however, by default, insert a vertical spacing between paragraphs. Many users try to emulate the look of the printed page (no additional vertical spacing) by typing a simple line feed between what they consider to be paragraphs. This is an error which can make their site more difficult to maintain and develop. The correct solution is to define a stylesheet (CSS) in one's templates which describes the layout behaviour of paragraphs (i.e. whether or not there is an additional vertical space between paragraphs, the amount of indentation of the first line, etc.).
- You can create nested lists by
adding asterisks after the list dash.
For example:
-* Your horse is:
-** chestnut;
-** bay;
-** black;
-* but my rabbit is
-** white:
-*** angora
-*** or short-haired.
gives:
-* Your horse is:
-** chestnut;
-** bay;
-** black;
-* but my rabbit is
-** white:
-*** angora
-*** or short-haired.
- Lastly, ordered list can be made using the following symbol #
instead of the star:
-# first
-# second
-# third
returns:
-# first
-# second
-# third
- {{Hyperlinks to an external glossary}}
You can also very quickly create a hyperlink
to a definition in an external glossary.
For any given term, you simply insert this
shortcut in your text [?term]
.
So the following code:
"{Frankenstein} is the masterpiece of [?Mary Shelley]
."
will show on the screen:
"{Frankenstein} is the masterpiece of [?Mary Shelley]."
Remember to click the link in order to check that the term which has been entered
(whether a name or common noun) is spelt correctly
and links to a valid destination.
The default external glossary is[Wikipedia->http://www.wikipedia.org].
It is a multilingual encyclopaedia created co-operatively
and opened to all contributors over
the internet. 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.
- {{Неавтоматични бележки}}
In most cases, the aforementionned system
of automatic footnotes is fairly enough.However, you may
manage the footnotes in a non automatic fashion by "imposing"
the choice of the number or even the displayed text used to craft the link.
The general principle is that you put the clickable text between angle brackets at the beginning of the note, thus:
The text is annotated[[ This is the note.]]
Following this principle, you can:
- use automatically numbered notes[[By placing the text of the note between double square brackets.]], or
- force the number of the note[[<23> By putting the number between angle brackets: < and >]], or
- use asterisks to indicate a note[[<*> By putting an asterisk between the angle brackets < and >]], or
- add notes without any visible link to/from the main text. You do this by[[<> Putting angle brackets <> with nothing between them.]], or
- give an abbreviation or name as the link to the note; in some languages this is often used for references indicating authorship of quotations[[ François Rabelais.]], or
- add a link to an existing note[[<23>]] by placing the number of the note between angle brackets, < and >, and giving no text to the note.
returns:
You may use footnotes numbered automatically [[By putting the text of the footnote between square brackets.]],
- but you may also impose the numbering of the footnote [[<23> By indicating its number between the characters «<» and «>».]],
- or use the footnotes in the form of a star [[<*> By putting a star between the charecters «<» and «>».]],
- craft unreferenced footnotes (without any number); bear in mind however, that these footnotes don't bear any more a link between the footnote and the spot where it is inserted[[<> By putting nothing between the characters «<» and «>».]],
- or give a name (fully spelled) to the footnote; this is frequently used for bibliographic references[[ William Shakespear.]];
- point to an existing note[[<23>]] by indicating its number between the characters «<» and «>». and leaving the rest of the note empty.
- {{Избягване на командите за ускорен достъп на СПИП}}
In some cases, it can be useful to tell SPIP
that some parts of a document should not be «processed» by the typographical shortcuts filter:
you do not want to correct the typography or you want to display source code (e.g. in PHP, JavaScript...).
The code of this shortcut is: «<HTML>Warning; text to leave as is</HTML>», which gives: «Warning; text to leave as is».
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!
- {{Показване на програмния код}}
Някои потребители биха желали в даден случай да бъде показан програмния код на тези страници.
За тази цел е налице командата да ускорен достъп ...
.
Example:
echo "hello";
?>
gives
There is another shortcut to display extract from programming code on several lines:
....This will put the code in a "form" (It is often used
in the present page). The advantage of this method is to make it easier to copy-paste from
you web page: you just have to move the cursor to the code you wish to copy, to choose "select all"
to be able to directly copy the code. Furthermore, in many browsers, this frame (cadre) allows a
better rendering of the tabs at the beginning of the lines.
Here is an example:
class Text {
var
type = 'text';
var
text;
}
class Field{
var
type = 'field';
var
field_name,
field_id;
var
cond_before,
cond_after; // table of objects
var
functions;
}
-------
{{{Hierarchical structure of the sections}}}
Структурата на рубриките представлява рамката на сайта Ви; тя определя интерфейса, начина на работа с него, взаимоотношенията между статиите и новините и т.н.
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.
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}.
{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.}
{{Only administrators can create, modify or delete sections.}}
{{{Syndicated sites}}}
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 «backend file».
Файлът може лесно и автоматично да бъде анализиран, за да може постоянно да се следи списъка на последните новини от такива сайтове. По този начин СПИП дава възможност да се покаже, на собствения Ви сайт, списъка с най-скорошните статии, публикувано на други сайтове.
For each referenced site 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.
- {{How to find the files «backend.php3»?}}
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 «bakend.php3» (or «backend.php»). For example, concerning uZine (http://www.minirezo.net/), the backend file address is:
http://www.minirezo.net/backend.php
Other examples of backend files include: