Compare commits

...

No commits in common. 'master' and 'spip-3.2' have entirely different histories.

  1. 7
      .gitignore
  2. 15
      CHANGELOG.md
  3. 3
      README.md
  4. 4
      aide-logo.svg
  5. 9
      aide/ar/raccourcis/_intro.spip
  6. 9
      aide/ar/raccourcis/ancre.spip
  7. 19
      aide/ar/raccourcis/citation.spip
  8. 63
      aide/ar/raccourcis/code.spip
  9. 26
      aide/ar/raccourcis/glossaire.spip
  10. 97
      aide/ar/raccourcis/lien.spip
  11. 44
      aide/ar/raccourcis/liste.spip
  12. 38
      aide/ar/raccourcis/note.spip
  13. 59
      aide/ar/raccourcis/resume.spip
  14. 75
      aide/ar/raccourcis/simple.spip
  15. 70
      aide/ar/raccourcis/tableau.spip
  16. 7
      aide/en/raccourcis/_intro.spip
  17. 10
      aide/en/raccourcis/ancre.spip
  18. 16
      aide/en/raccourcis/citation.spip
  19. 44
      aide/en/raccourcis/code.spip
  20. 21
      aide/en/raccourcis/glossaire.spip
  21. 82
      aide/en/raccourcis/lien.spip
  22. 47
      aide/en/raccourcis/liste.spip
  23. 39
      aide/en/raccourcis/note.spip
  24. 59
      aide/en/raccourcis/resume.spip
  25. 67
      aide/en/raccourcis/simple.spip
  26. 48
      aide/en/raccourcis/tableau.spip
  27. 5
      aide/es/raccourcis/_intro.spip
  28. 6
      aide/es/raccourcis/ancre.spip
  29. 13
      aide/es/raccourcis/citation.spip
  30. 53
      aide/es/raccourcis/code.spip
  31. 9
      aide/es/raccourcis/glossaire.spip
  32. 65
      aide/es/raccourcis/lien.spip
  33. 36
      aide/es/raccourcis/liste.spip
  34. 33
      aide/es/raccourcis/note.spip
  35. 55
      aide/es/raccourcis/resume.spip
  36. 57
      aide/es/raccourcis/simple.spip
  37. 63
      aide/es/raccourcis/tableau.spip
  38. 7
      aide/fr/raccourcis/_intro.spip
  39. 8
      aide/fr/raccourcis/ancre.spip
  40. 20
      aide/fr/raccourcis/citation.spip
  41. 65
      aide/fr/raccourcis/code.spip
  42. 32
      aide/fr/raccourcis/glossaire.spip
  43. 99
      aide/fr/raccourcis/lien.spip
  44. 45
      aide/fr/raccourcis/liste.spip
  45. 49
      aide/fr/raccourcis/note.spip
  46. 59
      aide/fr/raccourcis/resume.spip
  47. 92
      aide/fr/raccourcis/simple.spip
  48. 74
      aide/fr/raccourcis/tableau.spip
  49. BIN
      aide_logo-32.png
  50. 9
      aide_options.php
  51. 18
      composer.json
  52. 345
      inc/aide.php
  53. 31
      lang/aide.xml
  54. 24
      lang/aide_ar.php
  55. 24
      lang/aide_de.php
  56. 24
      lang/aide_en.php
  57. 24
      lang/aide_es.php
  58. 22
      lang/aide_fr.php
  59. 24
      lang/aide_fr_tu.php
  60. 24
      lang/aide_it.php
  61. 24
      lang/aide_pt.php
  62. 24
      lang/aide_pt_br.php
  63. 33
      lang/paquet-aide.xml
  64. 16
      lang/paquet-aide_ar.php
  65. 16
      lang/paquet-aide_de.php
  66. 16
      lang/paquet-aide_en.php
  67. 16
      lang/paquet-aide_es.php
  68. 2
      lang/paquet-aide_fr.php
  69. 16
      lang/paquet-aide_fr_tu.php
  70. 16
      lang/paquet-aide_it.php
  71. 16
      lang/paquet-aide_pt.php
  72. 16
      lang/paquet-aide_pt_br.php
  73. 9
      paquet.xml
  74. 14
      phpcs.xml.dist
  75. 57
      phpstan-baseline.neon
  76. 11
      phpstan.neon.dist
  77. 109
      prive/squelettes/contenu/aide.html
  78. 117
      prive/squelettes/contenu/aide_fonctions.php

7
.gitignore vendored

@ -1,7 +0,0 @@
/vendor/
/composer.phar
/composer.lock
/phpcs.xml
/phpstan.neon
/.php_cs.cache
/.php_cs.txt

15
CHANGELOG.md

@ -1,15 +0,0 @@
# Changelog
## [Unreleased]
## Added
- Fichier `README.md`
## Changed
- Compatible SPIP 4.2.0-dev
## Fixed
- #4619 correction d'une typo dans aide/fr/raccourcis/resume.spip

3
README.md

@ -1,3 +0,0 @@
# Plugin Aide
Ce plugin permet d’inclure une aide contextuelle dans SPIP

4
aide-logo.svg

@ -1,4 +0,0 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="64" height="64">
<circle cx="256" cy="256" r="256" fill="#666"/>
<path d="M245.3 426.7c-17.6 0-32-14.4-32-32s14.4-32 32-32 32 14.4 32 32-14.3 32-32 32zm32-130.2v34.1c0 5.9-4.8 10.7-10.7 10.7H224c-5.9 0-10.7-4.8-10.7-10.7v-53.3c0-23.5 19.1-42.7 42.7-42.7s42.7-19.1 42.7-42.7-19.1-42.7-42.7-42.7-42.7 19.1-42.7 42.7v10.7c0 5.9-4.8 10.7-10.7 10.7H160c-5.9 0-10.7-4.8-10.7-10.7V192c0-58.8 47.9-106.7 106.7-106.7S362.7 133.2 362.7 192c0 51.2-36.1 94.6-85.4 104.5z" fill="#fff"/>
</svg>

Before

Width:  |  Height:  |  Size: 554 B

9
aide/ar/raccourcis/_intro.spip

@ -1,9 +0,0 @@
<!-- ig br -->
{{لتسهيل تصميم الصفحات في الوثائق المنشورة في SPIP، يوفر النظام عدداً من «اختصارات الكتابة» التي تهدف الى:
- تبسيط الاستخدام للمستخدمين الذين لا يتقنون HTML؛
- تسهيل معالجة تصميم الصفحات الآلية.}}
بالطبع يمكنكم دائماً استخدام علامات HTML في صفحاتكم، الا اننا ننصحكم بتفضيل هذه الاختصارات (ليست كثيرة) الاكثر سهولة للتذكر والتي تتيح خاصة للنظام بعض العمليات الآلية.

9
aide/ar/raccourcis/ancre.spip

@ -1,9 +0,0 @@
<!-- ig br -->
بمكن تحديد «مراسي HTML» لإنشاء رابط مباشر الى نقطة معينة داخل صفحة من الموقع. فيكفي هنا ادخال المختصر:
<cadre>[<-مباشر]</cadre>
مما ينشئ مرساة اسمها <code>مباشر</code>. فعلى سبيل المثال، اذا كنا في المقال 3723، يقود عنوان URL <code>http://monsite/article.php3?id_article=3723#مباشر</code> مباشرة الى المكان الذي توجد فيه هذه المرساة في المقال.
تجدر الاشارة الى ان المراسي تتوافق مع [وصلات هايبرتكست داخل الموقع ->#liensite]. فمثلاً يقود المختصر «<code>[هذه النقطة بالذات->art123#ذات]</code>» الى المرساة المسماة «<code>ذات</code>» والمحددة في المقال 123.

19
aide/ar/raccourcis/citation.spip

@ -1,19 +0,0 @@
<!-- ig br -->
غالباً ما يفضل، في منتدى نقاش، ذكر مقتطف من المشاركة التي نردون عليها. لجعل عرض تلك المقتطفات اكثر تجانساً، يقدم SPIP الاختصار <html><tt><quote>...</quote></tt></html>.
على سبيل المثال:
<cadre>
<quote>نظام SPIP شيق للغاية.</quote>
انا رأيي من رأيك :-)
</cadre>
تعطي:
<quote><quote>نظام SPIP شيق للغاية.</quote>
انا رأيي من رأيك :-)</quote>

63
aide/ar/raccourcis/code.spip

@ -1,63 +0,0 @@
<!-- ig br -->
هناك بعض المستخدمين الذين يريدون عرض رموز برمجية في صفحاتهم. ويأتي الاختصار <<HTML><TT>&lt;code>...&lt;/code></TT></HTML> ليمكنهم من ذلك.
<cadre> <code><?php // هذه أوامرphp
echo "مرحباً";
?></code>
</cadre>
نحصلون على
<quote>
<code><?php //PHP هذه أوامر
echo "مرحباً";
?></code>
</quote>
هناك اختصار يتيح عرض مقتطفات من الرموز البرمجية تبلغ عدة اسطر:
<html><tt><cadre>...</cadre></tt></html>. يضع هذا الاختصار الرموز البرمجية داخل "استمارة" (كثيراً ما يستخدم ذلك
في الصفحة التي بين يديكم). اما ميزة هذا الاسلوب، فهي تسهيل النسخ واللصق من صفحتك على النسيج:
فيكفي وضع مؤشر الفأرة داخل الفقرة البرمجية واختيار امر "تحديد الكل" للتمكن من نسخ الفقرة مباشرة. اضافة الى ذلك،
وفي العديد من برامج التصفح، يتيح هذا الاطار استرجاعاً اميناً للحقول الموجودة في اول السطور.
في المقابل لا يدعم هذا الاطار اتجاه الكتابة من اليمين الى اليسار.
وهذا مثال:
<cadre>
class Text {
var
type = 'text';
var
text;
}
class Field {
var
type = 'field';
var
field_name,
field_id;
var
cond_before,
cond_after; // جدول عناصر
var
functions;
}
</cadre>
{{{تعطيل إختصارات SPIP}}}
في بعض الحالات، يصبح من المفيد إعلام SPIP بأنه لا يجب ان «يعالج» بعض إجزاء المستند
باستخدام مرشحات إختصارات الكتابة: فإما انك لا تريد تصحيح الكتابة او تريد عرض
رموز برمجية (مثلاً رموز PHP او جافاسكريبت...).
للحصول على ذلك، يجب إدخال
«<code><HTML>تحذير، نص غير مطلوب تنسيقه&</HTML></code>»،
مما يعطي:
<quote>
«<HTML>تحذير، نص غير مطلوب تنسيقه</HTML>».
</quote>

26
aide/ar/raccourcis/glossaire.spip

@ -1,26 +0,0 @@
<!-- ig br -->
يمكنكم أيضاً وبسرعة إنشاء رابط هايبرتكست الى تفسير اي عبارة موجودة في معجم خارجي.
فيكفي، للوصول الى عبارة ما، إدراج إختصار <code>[?العبارة]</code> في مادة المقال.
على سبيل المثال، فإن الاختصار التالي:
<code>كتاب الأجنحة المتكسرة هو من أعمال [جبران خليل جبران?] المهمة</code>
يظهر هكذا:
«كتاب الأجنحة المتكسرة هو من أعمال [جبران خليل جبران?] المهمة».
ويستحسن النقر على هذه الوصلة للتأكد من ان العبارة المدخلة (إسم جنس او إسم علم)
لا تحتوي على أخطاء إملائية وانها تتوجه الى الهدف الصحيح.
اما المعجم الخارجي الافتراضي المستخدم هنا، فهو [Wikipedia->http://www.wikipedia.org]، الذي يفرض بعض
[القواعد على عناوين المقالات->http://ar.wikipedia.org/wiki/ويكيبيديا:تسمية_المقالات].
هذه الموسوعة المتعددة اللغات مؤلفة بشكل تعاوني ومفتوحة لكل المساهمات عبر الشبكة. نرجو ان تأخذوا شيئاً من وقتكم
وتتعرفون على هذه الموسوعة وتساهمون فيها لإغناء هذه الذخيرة المعرفية المشتركة.
يمكن أيضاً اختيار مرجع آخر للفهرس بوضع رمز # يتبعه اسم الفهرس {{«ف»}} (مثلاً) بعد الكلمة المطلوب البحث عنها. فيقوم SPIP يتطبيق دالة <tt>glossaire_</tt>{{ف}} على الكلمة للحصول على الرابط المطلوب ادراجه.
ويجب وضع هذه الدالة في ملف <tt>mes_options.php</tt>. واذا كان الاسم {{«ف»}} ينتهي بأرقام سيتم سحب هذه الأرقام قبل تطبيق الدالة لتشكل المعامل الثاني في الدالة وهذا الشيء مفيد جداً في حال كان الفهرس المشار اليه يتكون من أبواب مختلفة. نكتب اذن:
<cadre>[?read#man2]</cadre>
للدلالة على اننا نرجع تفسير كلمة <tt>read</tt> الى الباب ٢ من الفهرست المسمى <tt>man</tt>.
وفي ما يتعلق باختصارات ذكر اللغة وانشاء بالون حوار المذكورة أعلاه في الوصلات الخارجية، فإنها تعمل هنا ايضاً.

97
aide/ar/raccourcis/lien.spip

@ -1,97 +0,0 @@
<!-- ig br -->
يمكنك بسهولة إنشاء روابط هايبرتكست باستخدام الرموز التالية:
<cadre>
نظام SPIP هو مبادرة من [مينيريزو->http://www.minirezo.net/].
</cadre>
تصبح:
<quote>نظام SPIP هو مبادرة من [مينيريزو->http://www.minirezo.net/].</quote>
(للتذكير: الخط الافقي الذي يتبعه رمز "اكبر من" يظهر على شكل سهم يدل الى ان نص الرابط - قبل السهم - "يشير نحو" العنوان.)
يمكن للرابط ان يكون عنواناً مطلقاً (اي يبدأ، كما في مثالنا، بعبارة <code>http://</code>)
او عنواناً نسبياً (يصل الى صفحة اخرى من الموقع نفسه) او رابط الى مستند يستخدم احد بروتوكولات انترنت
(<code>ftp://</code>...) او عنوان بريد الكتروني («<code>[->mailto:minirezo@rezo.net]</code>»)...
تطبيق محدد: يمكنك عرض رابط يُنقر بالاحرف الكاملة على شكل عنوان URL،
دون ادخال اي شيء قبل "السهم".مثلاً:
<cadre>[->http://dmoz.org/World/Arabic/arts/literature/novel/]</cadre>
تعرض:
<quote>[->http://dmoz.org/World/Arabic/arts/literature/novel/]</quote>
لاحظ انه في حال عناوين URL الطويلة، يظهر عرضها مبتوراً (لتفادي افساد تصميم الصفحة)
لكن رابط هايبرتكست يبقى سليماً بحيث يؤدي الى العنوان الصحيح.
[liensite<-]
من الممكن تحديد لغة الصفحة التي يدل اليها الرابط حسب ما تعرض برامج التصفح. فيكفي لذلك وضع رمز اللغة داخل هلالين:
<cadre>[موقع عربي{ar}->http:///www.address.tld]</cadre>
وينصح بذلك عندما لا تكون الصفحة الهدف بنفس لغة نصك.
واذا اردنا الكثير من المعلومات حول الرابط ولكن دون تكبير المساحة التي يتم نقرها، يمكن عرض بالون حوار بوضع رمز | يتبعه النص المطلوب قبل سهم الرابط:
<cadre>[أنظر هنا|هذا الرابط سيوضّح كل شيء ->http:///www.adresse.tld]</cadre>
سيعرض <tt>أنظر هنا</tt> ولا يظهر النص الآخر الا عند تمرير مؤشر الفأرة فوق الرابط.
- {{روابط هايبرتكست داخل الموقع}}
إضافة الى ذلك، فإن نظام روابط هايبرتكست نفسه يسهّل إنشاء الروابط داخل موقعك بواسطة SPIP.
والحيلة الوحيدة هنا هي العثور على {{رقم}} المقال او القسم او الخبر الذي يجب ان يدل اليه الرابط:
<img src="AIDE/ar/articlenumero.gif" alt="NUMERO" border="0" align="right">
عندما «تزورون» مقالاً او خبراً او قسماً في المجال الخاص، يظهر في العمود الأيمن مربع يعرض الرقم بوضوح.
وهذا الرقم هو الذي يجـب ادخاله في رابط هايبرتكـست:
-* رابط الى المقال 342 (أربعة إمكانات):}
<HTML><TT>
<br />رابط الى [المقال->342]
<br />رابط الى [المقال->art342]
<br />رابط الى [المقال->article 342]
<br /></tt></html>
تطبيق محدد:<HTML><TT>[->art342]</tt></html> (لم نحدد شيئاً قبل "السهم") يعرض آلياً
عنوان المقال 342 مع رابط الى هذا المقال.
-* رابط الى القسم 12:}
<HTML><TT>
رابط الى [القسم->rub12]<br />
رابط الى [القسم->rubrique 12]
<br />
</tt>
</html>
-* رابط الى القسم 12:}
<HTML><TT>
<br />رابط الى [الخبر->br65]
<br />رابط الى [الخبر->breve 65]
<br />رابط الى [الخبر->br&egrave;ve 65]
</tt></html>
-* المؤلفون والمفاتيح والمواقع والصور والمستندات:}
<HTML><TT>
<br />رابط الى [مؤلف->aut13] او [المؤلف نفسه->auteur13]
<br />رابط الى [مفتاح->mot32]
<br />رابط الى [موقع مرخص->site1]
<br />رابط الى [مستند مرفق->doc17] او [المستند نفسه->document17]
<br />رابط الى [صورة->img13] او [الصورة نفسها->image13]
<br />
</tt></html>
تطبيق محدد: هنا ايضاً، يمكننا عدم تحديد اي شيْ قبل "السهم"
(<html><tt>[->aut13]</tt></html>...).
سيقوم SPIP آلياً بإدراج المعلومات الضرورية. في حال كان الرابط عائداً الى صورة او مستند مرفق، واذا ادخلنا عنواناً يدوياً، فإن هذا العنوان هو الذي سيعرض والا فسيتم استخدام اسم الملف.
وفي ما يتعلق باختصارات ذكر اللغة وانشاء بالون حوار المذكورة أعلاه في الروابط الخارجية، تعمل هنا ايضاً.
<div align='left'><a href='#glossaire'>لمزيد من المعلومات: وصلة الى معجم</a>
_ [مراسي تحمل اسماء->#ancres]</div>

44
aide/ar/raccourcis/liste.spip

@ -1,44 +0,0 @@
<!-- ig br -->
- تحصل على عودة عادية الى اول السطر بإدخال <tt>_</tt>
(وهو {underscore} بالانكليزية) في اول السطر الجديد، تتبعه مسافة.
{ملاحظة.} في الكتابة التقليدية، العودة الى السطر نادرة جداً (اللهم الا في الشعر). وغالباً ما نحسبها بداية فقرة جديدة كما يظهر في المواد المطبوعة (اي دون مسافة عمودية بين الفقرات) بينما برامج التصفح تدخل مسافة بين الفقرات افتراضياً. وهناك العديد من المستخدمين الذين يحاولون تقليد خاصية الطباعة (اي عدم وجود مسافة عمودية) بإدخال عودة عادية الى اول السطر مما يشكل خطأً قد يلحق الضرر بصيانة الموقع. والحل هو استخدام ورقة انماط (CSS) في الصفحة النموذجية تحدد تصرف الفقرات (اي حسب الظروف، عدم ادخال مسافة عمودية بين الفقرات، فراغ قبل السطر الاول...).
يمكن إنشاء لوائح متداخلة بإدخال نجوم بعد الخط الصغير.
هكذا:
<cadre>
-* لون فرسك:
-** أشقر؛
-** أدهم؛
-** أشهب؛
-* لكن قطتي
-** بيضاء:
-*** أنقرية
-*** او فارسية زرقاء.</cadre>
مما يعطي:
<quote>
-* لون فرسك:
-** أشقر؛
-** أدهم؛
-** أشهب؛
-* لكن قطتي
-** بيضاء:
-*** أنقرية
-*** او فارسية زرقاء.</quote>
أخيراً، يمكن إنشاء لوائح مرقمة باستخدام <code>#</code> بدلاً من النجمةّ:
<cadre>
-# الأول
-# الثاني
-# الثالث</cadre>
تعطي:
<quote>
-# الأول
-# الثاني
-# الثالث</quote>

38
aide/ar/raccourcis/note.spip

@ -1,38 +0,0 @@
<!-- ig br -->
عادة يُستدل الى الحاشية بواسطة رقم مدرج في
المادة ومكرر في أسفل الصفحة لتوفير معلومات إضافية.
في SPIP، هذه الوظية (الصعبة جداً اذا اردنا التحكم بها يدوياً في HTML) آلية:
فيقوم SPIP بترقيم الحواشي وإدارة وصلات هايبرتكست داخل المستند للقفز مباشرة من رقم الحاشية الى الحاشية نفسها وبالعكس..
تتم الدلالة الى الحاشية بوضعها ضمن معقّفين مزدوجين:
«<HTML><TT>حاشية[[هذه معلومات اضافية.]] في اسفل الصفحة.</TT></HTML>»
تظهر هكذا: «حاشية[[هذه معلومات اضافية.]] في اسفل الصفحة.»
- {{{حواشي غير آلية}}}
في أغلب الأحيان، يعتبر نظام إنتاج الحواشي الآلي المذكور أعلاه كافياً.
الا انكم تستطيعون التحكم بالحواشي بطريقة غير آلية بـ"فرض"
خيار الرقم او العبارة الظاهرة لتحقيق الوصلة.
المبدأ هو تحديد خيارك للعبارة المستخدمة ضمن رمزي «<» و«>» في بداية الحاشية:
<cadre>حاشية «مفروضة» [[<xxx> نص الحاشية.]]</cadre>
هكذا:
<cadre>يمكنكم استخدام حواشي آلية مرقمة [[بوضع نص الحاشية ضمن معقّفين مزدوجين.]]،
- لكن يمكنكم أيضاً فرض ترقيم الحواشي [[<23> بتحديد رقم الحاشية ضمن رمزي «<» و«<».]]،
- إستخدام حواشي يُرمز اليها بنجوم [[<*> بوضع نجمة ضمن رمزي «>» و«<».]]،
- إنشاء حواشي دون رموز (او ترقيم) ولكن انتبهوا الى ان هذه الحواشي لا توفر وصلات بين الحاشية والمكان الذي تدل اليه [[<> بترك رمزي «>» و«<» فارغين.]]،
- إعطاء إسم (كامل) للحاشية وهو شاءع في المراجع [[<نوا> ابو نواس.]]،
- إعادة الى حاشية موجودة مسبقاً [[<23>]] بتحديد رقم هذه الحاشية ضمن رمزي «<» و«>» وترك باقي الحاشية فارغاً.</cadre>
تعطي:
<quote>يمكنك استخدام حواشي آلية مرقمة [[بوضع نص الحاشية ضمن معقّفين مزدوجين.]]،
- لكن يمكنك أيضاً فرض ترقيم الحواشي [[<23> بتحديد رقم الحاشية ضمن رمزي «<» و«<».]]،
- إستخدام حواشي يُرمز اليها بنجوم [[<*> بوضع نجمة ضمن رمزي «>» و«<».]]،
- إنشاء حواشي دون رموز (او ترقيم) ولكن انتبه الى ان هذه الحواشي لا توفر وصلات بين الحاشية والمكان الذي تدل اليه [[<> بترك رمزي «>» و«<» فارغين.]]،
- إعطاء إسم (كامل) للحاشية وهو شاءع في المراجع [[<نوا> ابو نواس.]]،
- إعادة الى حاشية موجودة مسبقاً [[<23>]] بتحديد رقم هذه الحاشية ضمن رمزي «<» و«>» وترك باقي الحاشية فارغاً.</quote>

59
aide/ar/raccourcis/resume.spip

@ -1,59 +0,0 @@
<pre><code class="language-spip_typo">
{{{ عنوان فقرة }}}
نص {مائل} او {{أسود}} او {{ {الإثنان معاً} }}.
عودة الى أول السطر مع [رابط خارجي->https://www.spip.net] و[رابط داخلي->art12] وعنوان آلي [->rubrique10].
فقرة أخرى مع [[حاشية في أسفل الصفحة]] وعبارة من [?معجم].
-* لائحة
-* لائحة
-** عنصر من لائحة
-# لائحة مرتبة
-# لائحة مرتبة
-## عنصر من لائحة مرتية
فاصل
----
جدول
| {{ مكان }} | {{ عمل }} |
| الكهوف | حفلة Spip |
| أصفهان | Spip بالأزرق |
تعريف مرساة [مباشرة<-] مع مكان يتم الذهاب اليه [->#كان يت].
<quote>مقتطف</quote>
</code></pre>
{{{ عنوان فقرة }}}
نص {مائل} او {{أسود}} او {{ {الإثنان معاً} }}.
عودة الى أول السطر مع [رابط خارجي->https://www.spip.net] و[رابط داخلي->art12] وعنوان آلي [->rubrique10].
فقرة أخرى مع [[حاشية في أسفل الصفحة]] وعبارة من [?معجم].
-* لائحة
-* لائحة
-** عنصر من لائحة
-# لائحة مرتبة
-# لائحة مرتبة
-## عنصر من لائحة مرتية
فاصل
----
جدول
| {{ مكان }} | {{ عمل }} |
| الكهوف | Spip حفلة |
| أصفهان | Spip بالأزرق |
تعريف مرساة [مباشرة<-] مع مكان يتم الذهاب اليه [->#كان يت].
<quote>مقتطف</quote>

75
aide/ar/raccourcis/simple.spip

@ -1,75 +0,0 @@
<!-- ig br -->
في مرحلة اولى، نقدم هنا اختصارات الكتابة الاكثر شيوعاً وسهولة. اما للمستخدمين الذين يرغبون التحكم بدقة اكبر بتنسيق نصوصهم، فسنقدم نكهات اكثر تعقيداً من هذه الاختصارات.
{ملاحظة.} تلبي الاختصارات البسيطة معظم الحاجات وتسمح بالنشر على النسيج بسهولة كتابة الرسائل الالكترونية.
{{{الكتابة الفرنسية الآلية}}}
يطبق SPIP قواعد الكتابة الفرنسية في المواقع الفرنسية فقط.
{{{إنشاء الفقرات}}}
لإنشاء الفقرات، يمكن ببساطة ترك سطر فارغ تماماً كما تنشئ فقرات
في اي معالج نصوص او في الرسائل الالكترونية (بمعنى آخر «القفز» سطراً).
لا يكفي الضغط على زر الإدخال لإنشاء فقرة جديدة يجب ان ترك سطر فارغ
(في الحقيقة لا يؤدي الضغط على زر الإدخال حتى الى العودة الى اول السطر).
يمكن ترك عدة سطور فارغة دون التأثير على تصميم الصفحة.
[puces<-]
{{{إنشاء لوائح مرقمة او مبوبة}}}
يمكن إنشاء لوائح في SPIP بالطريقة نفسها التي تنشئ بها لوائح في الرسائل الالكترونية:
يكفي الضغط على زر الإدخال وبدء السطر الجديد بخط صغير («-»).
من الملاحظ هنا ان مجرد الضغط على زر الإدخال يكفي (بالتالي يمكنك انشاء لوائح في الفقرة نفسها)؛
اما اذا ترك سطر فارغ قبل السطر الذي يبدأ بالخط الصغير، فسيظهر سطر فارغ قبل اللائحة.
على سبيل المثال،<cadre>
- من طال أمَدُه
- وكَثُر ولَدُه
- ورقَّ عَدَدُه
- ذهب جَلَدُه. (إبن الأعرابي)
</cadre>
تظهر هكذا:
<quote>
- من طال أمَدُه
- وكَثُر ولَدُه
- ورقَّ عَدَدُه
- ذهب جَلَدُه. (إبن الأعرابي)</quote>
<div align='left'>
[مزيد من المعلومات عن اللوائح->#listes]
</div>
{{{الأسود والمائل}}}
تحول نصاً ما الى {مائل} بوضعه ضمن قوسين: «<HTML><TT> ... هذا نص {مائل} في... </TT></HTML>» . ال
ا اننا ننصح بعدم الإفراط في استخدام المائل لأن أطقم الحروف العربية الموجودة على النسيج لا تدعمه
وبالتالي فإنها تميل الى الجهة غير الصحيحة مما يجعل النص قبيحاً وأحياناً غير واضحاً في بعض برامج التصفح.
ينصح بالستخدام المائل فقط في حال وجود هذا النمط في اي خط عربي خاص يتم استخدامه في الموقع.
وتحول نصاً ما الى {{أسود}} بوضعه ضمن قوسين مزدوجين: «<HTML><TT> ... هذا النص {{أسود}} في... </TT></HTML>» .
{{{عناوين الفقرات}}}
عناوين الفقرات هي عناوين داخل المادة تدل الى الفقرات وبالتالي الى بنية هذه المادة. وهي سهلة جداً في SPIP، فيمكن الحصول عليها بوضع نصها ضمن أقواس ثلاثية: «<HTML><TT>{{{عنوان فقرة}}}</tt></html>» يعطي:
<quote>{{{عنوان فقرة}}}</quote>
{{{خط أفقي}}}
من السهل جداً إدخال خط أفقي (او خط فصل) داخل المادة: فيكفي إدخال خط مكون من أربع خطوط صغيرة («-») على الأقل، هكذا:
<cadre>----</cadre>
تعطي:
<quote>
----
</quote>

70
aide/ar/raccourcis/tableau.spip

@ -1,70 +0,0 @@
<!-- ig br -->
لإنشاء جداول بسيطة في SPIP، يكفي إدخال سطور يفصل بين «خاناتها» رمز «|» (خط عمودي)،
مع التأكد من ان هذه السطور تبدأ وتنتهي بسطر فارغ. من الضروري ترك سطر فارغ قبل الجدول وبعده.
على سبيل المثال، يتم إنشاء الجدول:
| {{الإسم}} | {{الكنية}} | {{السن}} |
| عفيف | ناصر | ٣١ سنة |
| ابو سعيد | | غير معروف |
| جميل | ناعم | ٢٣ سنة |
| سميرة | حداد | ٥ أشهر |
هكذا:
<cadre>
| {{الإسم}} | {{الكنية}} | {{السن}} |<br/>
| عفيف | ناصر | ٣١ سنة |<br/>
| ابو سعيد | | غير معروف |<br/>
| جميل | ناعم | ٢٣ سنة |<br/>
| سميرة | حداد | ٥ أشهر |<br/>
</cadre>
لاحظوا ان كل مداخل السطر الاول تظهر بالاسود. يعرف SPIP هكذا انه سطر البداية
ويعطيه شكلاً مختلفاً عن سائر الاسطر (اي لون خلفي مختلف). ان وجود سطر مثل هذا غير الزامي.
يمكن ايضاً اضافة تعليق وملخص على الجدول. هتان المعلومتان اختياريتان ولكنهما ضروريتان
لجعل الجدول اكثر وضوحاً للمعوقين بصرياً لأن الملخص يعطي فكرة اوضح عن محتوى الجدول.
وتظهر هتان المعلومتان بين خطين عموديين مزدوجين في اعلى الجدول هكذا:
<cadre>
||تعليق|ملخص||
| {{الاسم}} | {{تاريخ الولادة}} | {{المدينة}}|
| عفيف | ١٩٧٠/٥/١٠ | بيروت |
| ابوسعيد | ١٩٧٥/٢/١٢ | دمشق |
| جميل | ١٩٥٧/١/٣١ | بغداد |
| سميرة | ١٩٤٨/١٢/٢٣ | الخليل |
</cadre>
وتظهر هكذا:
||تعليق|ملخص||
| {{الاسم}} | {{تاريخ الولادة}} | {{المدينة}}|
| عفيف | ١٩٧٠/٥/١٠ | بيروت |
| ابوسعيد | ١٩٧٥/٢/١٢ | دمشق |
| جميل | ١٩٥٧/١/٣١ | بغداد |
| سميرة | ١٩٤٨/١٢/٢٣ | الخليل |
يمكن تجاهل اي من المعلومتين ولكن يجب وضع خط عمودي مفرد قبل الملخص: || | ملخص ||
يمكن أيضاً دمج خانة بخانة أخرى بخفض محتواها الى |<| لدمجها بالخانة التي تسبقها أفقياً او الى |^| لدمجها بالخانة التي تسبقها عمودياً.
<cadre>
||جدول مع الدمج| اختصار الدمج||
| {{عمود ١}} | {{عمود ٢}} | {{عمود ٣}} |
| سطر ١ | س١غ٢ وس١ع٣ |<|
| سطر ٢ | س٢ع٢ وس٣ع٢|س٢ع٣|
| سطر ٣ |^| س٣ع٣ |
</cadre>
donnera
||جدول مع الدمج| اختصار الدمج||
| {{عمود ١}} | {{عمود ٢}} | {{عمود ٣}} |
| سطر ١ | س١غ٢ وس١ع٣ |<|
| سطر ٢ | س٢ع٢ وس٣ع٢|س٢ع٣|
| سطر ٣ |^| س٣ع٣ |

7
aide/en/raccourcis/_intro.spip

@ -1,7 +0,0 @@
<!-- ig br -->
{{To make the layout of the documents published by SPIP an easier task, 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 recommend that you opt to use these few SPIP shortcuts instead, which are much easier to remember and more especially, provide the system with some automated operations.}}

10
aide/en/raccourcis/ancre.spip

@ -1,10 +0,0 @@
<!-- ig br -->
You can define "HTML anchors" within your text so that you can construct direct links into a specific section in the middle of a page of a SPIP site. This kind of shortcut is created like this one:
<cadre>[direct<-]</cadre>
and which will create an anchor named <code>direct</code> at that point in the text. So then for article 3723, the URL <code>http://mysite/article.php3?id_article=3723#direct</code> will link directly to the location in the article where that anchor has been inserted.
Note that anchors are also compatible with [hypertext links internal to the site->#liensite]. In this way, the shortcut "<code>[this exact point->art123#precis]</code>" will lead to the anchor named as "<code>precis</code>" defined within article 123.

16
aide/en/raccourcis/citation.spip

@ -1,16 +0,0 @@
<!-- ig br -->
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
<html><tt>&lt;quote>...&lt;/quote></tt></html>.
For example:
<cadre><quote>Pretty good that SPIP.</quote>
Right you are, rubber duck :-)</cadre>
gives:
<quote><quote>Pretty good that SPIP.</quote>
Right you are, rubber duck :-)</quote>

44
aide/en/raccourcis/code.spip

@ -1,44 +0,0 @@
<!-- ig br -->
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.
Example: <HTML><TT><code><?php &nbsp; &nbsp; //this is some php code<br>
echo "hello";<br>
?></code></TT></HTML> gives <code><?php //this is some php code
echo "hello";
?></code>
There is another shortcut to display extracts of programming code on several lines:
<html><tt>&lt;cadre>...&lt;/cadre></tt></html>.This will put the code in a "form" (It is often used on this current 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:
<cadre>
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;
}
</cadre>
{{Bypassing SPIP shortcuts}}
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><TT>&lt;HTML&gt;Warning; text to leave as is&lt;/HTML&gt;</TT></HTML>", which gives: "<HTML>Warning; text to leave as is</HTML>".

21
aide/en/raccourcis/glossaire.spip

@ -1,21 +0,0 @@
<!-- ig br -->
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 <code>[?term]</code>.
So the following code:
"<code>{Frankenstein} is the masterpiece of [?Mary Shelley]</code>."
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.
You can also reference another glossary be inserting the # symbol after the term in question, followed by the name {G} of the glossary. SPIP will then apply the <tt>glossaire_</tt>{G} function to the term to obtain the link to be inserted.
This function will have been entered into the <tt>mes_options.php</tt> file. If the name {G} ends with numerals, they will first be removed from that name, and will form the second argument to the function, which is very useful for a glossary that is divided into numbered sections. We would then write:
<cadre>[?read#man2]</cadre>
to indicate that we are referencing the explanation of the term <tt>read</tt> in section 2 of the glossary named as <tt>man</tt>.
The shortcuts for referencing the language and creating a tool-tip, explained above for the external links, works just as well for glossary references as well.

82
aide/en/raccourcis/lien.spip

@ -1,82 +0,0 @@
<!-- ig br -->
You can easily create a hypertext link with the following code:
<cadre>SPIP is an initiative from the [minirezo->http://www.minirezo.net/].</cadre>
which becomes
<quote>SPIP is an initiative from the [minirezo->http://www.minirezo.net/].</quote>
(To help remember this: 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.)
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 ("<code>[->mailto:minirezo@rezo.net]</code>")...
Specific application: when nothing is entered before the "arrow", the text of the passed URL is displayed as a clickable link. For example:
<cadre>[->http://dmoz.org/World/Deutsch/Kultur/Literatur/Autoren_und_Autorinnen/P/Proust,_Marcel/]</cadre>
returns:
<quote>[->http://dmoz.org/World/Deutsch/Kultur/Literatur/Autoren_und_Autorinnen/P/Proust,_Marcel/]</quote>
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 whole correct address.
[liensite<-]
It is possible to specify the language of the page that the link points to,
which browsers may display as they so choose. To do this, just put the language code between braces.
<cadre>[A site in French{fr}->http:///www.adresse.tld]</cadre>
This is particularly recommended whenever the destination page is not in the same language as your current source text.
If you want to provide a lot of information about the link without excessively extending the clickable zone, you can provoke the appearance of a tool-tip instead by inserting the vertical bar sign | before the arrow, and follow it with the text that you want in the tool-tip:
<cadre>[see here|This link will tell you everything you ever wanted to know about some very complex process->http:///www.adresse.tld]</cadre>
will display as <tt>see here</tt>, and the rest of the text will only appear when you move your mouse over the link.
- {{Hypertext links inside the site}}
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: <img src="AIDE/en/articlenumero.gif" alt="NUMERO" border="0" align="right"> when you "visit" an article, a news item or a section in the private area, the left-hand column contains a box indicating this number in large digits.
This is the number that you should insert in the hypertext link:
-* Link to article 342 (4 possibilities):
<HTML><TT>
<br />link to [article->342]
<br />link to [article->art342]
<br />link to [article->article 342]
<br /></tt></html>
A particular use: <HTML><TT>[->art342]</tt></html> (no text before the "arrow") will automatically display the title of article 342 with a link to that article.
-* Link to section 12:
<HTML><TT>
<br />link to [section->rub12]
<br />link to [section->rubrique 12]
</tt></html>
-* Link to news item 65:
<HTML><TT>
<br />link to [news item->br65]
<br />link to [news item->breve 65]
<br />link to [news item->br&egrave;ve 65]
</tt></html>
-* Authors, keywords, sites, images, documents:
<HTML><TT>
<br />link to [an author->aut13] or [the same author->auteur13]
<br />link to [a keyword->mot32]
<br />link to [a syndicated site->site1]
<br />link to [an attached document->doc17] or [the same document->document17]
<br />link to [an image->img13] or [the same image->image13]
</tt></html>
Specific application: here too, we can put nothing before the "arrow"
(<html><tt>[->aut13]</tt></html>...). SPIP will automatically insert the required information. In the case of an attached document or an image, if we manually entered a title, that title will be displayed; otherwise, the file name itself will be used.
<div align='right'>find out more: <a href='#glossaire'>links to a glossary</a>,
_ [ancres nommées->#ancres].
</div>

47
aide/en/raccourcis/liste.spip

@ -1,47 +0,0 @@
<!-- ig br -->
- {{Advanced management of lists and enumerations}}
- A simple carriage return can be performed by typing <tt>_</tt>
(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 your 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 hyphen.
For example:
<cadre>
-* Your horse is:
-** chestnut;
-** bay;
-** black;
-* but my rabbit is
-** white:
-*** angora
-*** or short-haired.</cadre>
gives:
<quote>
-* Your horse is:
-** chestnut;
-** bay;
-** black;
-* but my rabbit is
-** white:
-*** angora
-*** or short-haired.</quote>
- Lastly, ordered list can be made using the following symbol <code>#</code> instead of the asterisk:
<cadre>
-# first
-# second
-# third</cadre>
returns:
<quote>
-# first
-# second
-# third</quote>

39
aide/en/raccourcis/note.spip

@ -1,39 +0,0 @@
<!-- ig br -->
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: "<HTML><TT>A[[Here is additional information.]] footnote.</TT></HTML>" will be displayed as: "A[[Here is additional information.]] footnote."
{{{Non-automated notes}}}
In most cases, the aforementioned system of automatic footnotes is quite 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, like this:
<cadre>The text is annotated[[<xxx> This is the note.]]</cadre>
Following this principle, you can:
<cadre>
- 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[[<Rab> Fran&ccedil;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.
</cadre>
returns:
<quote>
- 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[[<Rab> Fran&ccedil;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.
</quote>

59
aide/en/raccourcis/resume.spip

@ -1,59 +0,0 @@
<pre><code class="language-spip_typo">
{{An intertitle }}}
Text with {italic} and {{bold}} or a {{ {mix of both} }}.
A line break with [an external link->https://www.spip.net] and [an internal link->art12] with an automatic title [->rubrique10].
Another paragraph with [[A footnote]] and a [?glossary] term.
-* A list
-* A list
-** A sub-element of a list
-# An ordered list
-# An ordered list
-## Sub-item of an ordered list
A separator
----
A table
| {{ Location }} | {{ Action }} |
| Caves | Spip Party |
|Toulouse | Spip in pink |
The definition of an anchor [direct<-] with a link to get there [->#direct].
<quote>A quote</quote>
</code></pre>
{{An intertitle }}}
Text with {italic} and {{bold}} or a {{ {mix of both} }}.
A line break with [an external link->https://www.spip.net] and [an internal link->art12] with an automatic title [->rubrique10].
Another paragraph with [[A footnote]] and a [?glossary] term.
-* A list
-* A list
-** A sub-element of a list
-# An ordered list
-# An ordered list
-## Sub-item of an ordered list
A separator
----
A table
| {{ Location }} | {{ Action }} |
| Caves | Spip Party |
|Toulouse | Spip in pink |
The definition of an anchor [direct<-] with a link to go there [->#direct].
<quote>A quote</quote>

67
aide/en/raccourcis/simple.spip

@ -1,67 +0,0 @@
<!-- ig br -->
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 will then later introduce some more complex versions of these shortcuts.
{N.B.} The simple shortcuts fulfil most of the formatting requirements, and make online publication almost as easy as writing an email.
- {{Automatic French typography}}
SPIP automatically accommodates the standard rules for spacing in French typography (and some other languages) - it will insert unbreakable white space before any occurrence of the characters
":", ";", "!", and "?",
and will insert unbreakable spaces before and after any phrases enclosed in «French style quotation marks».
(Note: this functionality is ONLY activated if the principal language for the site is French.)
- {{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. The redundant blank lines will just be eliminated.
- {{Creating bulleted or numbered lists}}
You can create lists in SPIP in the same way as in an e-mail: you only need to enter a line feed and start the new line with a dash/hyphen ("-").
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 hyphen, then a blank line will appear before the list
For example, <cadre>- I like work;
- it fascinates me.
- I can sit and look at it for hours.
(Jerome K. Jerome)</cadre>
will display:
<quote>
- I like work;
- it fascinates me.
- I can sit and look at it for hours.
(Jerome K. Jerome)
</quote>
<div align='right'><a href='#listes'>more information on the lists</a></div>
Note here that this is just inserting a {bullet}, and is not creating a list ([to create lists see->#listes])
{{Bold and italic}}
You specify a text in {italic} by placing it between simple braces: "<code>...some text {in italic} in...</code>».
You specify a text in {{bold}} by placing it between double braces: "<code>...some text {{in bold}} in...</code>".
- {{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: "<HTML><TT>{{{Section heading}}}</TT></HTML>" will display the heading, bold and centred:
<quote>{{{Section heading}}}</quote>
- {{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 hyphens, like this:
<cadre>----</cadre>
which will generate:
<quote>
----
</quote>

48
aide/en/raccourcis/tableau.spip

@ -1,48 +0,0 @@
<!-- ig br -->
To create simple tables in SPIP, you just have to create lines with "cells" separated by the symbol "|" ({vertical bar}), making sure that the lines start and end with vertical bars too. 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 like this:
<cadre>
| {{Surname}} | {{Forename}} | {{Age}} |
| Smith | John | 23 years |
| Captain | | not known |
| Bloggs | Philip | 46 years |
| Cadoc | Baby | 4 months |
</cadre>
Note that all the entries of the first row appear in bold. SPIP uses this identification to mean that this is the row containing the column headings and applies a presentation to it different from the other rows (different background colour). The presence of such a row is not mandatory.
You can also specify the optional caption and summary of the table. This information is quite important to make the table accessible, in particular, the summary gives a better view of the table without having to read through all the lines and columns.
_ This information is specified between two vertical lines before the table like this:
<cadre>
||Caption|Summary||
| {{Name}} | {{Date of birth}} | {{City}} |
| Jacques | 5/10/1970 | Paris |
| Claire | 12/2/1975 | Belfort |
| Martin | 1/31/1957 | Nice |
| Marie | 23/12/1948 | Perpignan |
</cadre>
and will be formatted as is:
||Caption|Summary||
| {{Name}} | {{Date of birth}} | {{City}} |
| Jacques | 5/10/1970 | Paris |
| Claire | 12/2/1975 | Belfort |
| Martin | 1/31/1957 | Nice |
| Marie | 23/12/1948 | Perpignan |
You don't have to specify both fields. In the case of setting only the table summary, you need to remember to put the single vertical line before it. Like this: <code>|| | Summary ||</code>

5
aide/es/raccourcis/_intro.spip

@ -1,5 +0,0 @@
{{Para facilitar la compaginación de los documentos publicados con SPIP, el sistema ofrece cierto número de «atajos SPIP» destinados:
- a simplificar la utilización por usuarios que no conozcan el HTML;
- a facilitar el tratamiento automático de la compaginación.}}
Por consiguiente, siempre se puede usar código HTML normal en los documentos SPIP, pero aconsejamos utilizar preferentemente este puñado de atajos SPIP

6
aide/es/raccourcis/ancre.spip

@ -1,6 +0,0 @@
Puedes definir «anclas HTML» para construir un enlace directo hacia un punto dado en mitad de una página de un sitio SPIP. Basta con introducir el atajo:
<cadre>[direct<-]</cadre>
el cual creará un ancla de nombre <code>direct</code>. Así, si tenemos, por ejemplo, el artículo 3723, la URL <code>http://mi.sitio/article.php3?id_article=3723#direct</code> conducirá directamente al lugar del artículo donde esté situado este ancla.
Hay que destacar que las anclas son compatibles con los [enlaces de hipertexto al interior del sitio->#liensite]. De este modo, el atajo «<code>[este punto exacto->art123#exacto]</code>» conducirá al ancla llamada «<code>exacto</code>» definida en el artículo 123.

13
aide/es/raccourcis/citation.spip

@ -1,13 +0,0 @@
En un foro de discusión, a veces es práctico poder citar un trozo del mensaje al que se está respondiendo. Para homogeneizar la presentación de tales citas, SPIP ofrece el atajo <html><tt>&lt;quote>...&lt;/quote></tt></html>.
Por ejemplo:
<cadre><quote>SPIP es tremendamente bueno.</quote>
Kikou, estoy muy de acuerdo :-)</cadre>
queda así:
<quote><quote>SPIP es tremendamente bueno.</quote>
Kikou, estoy muy de acuerdo :-)</quote>

53
aide/es/raccourcis/code.spip

@ -1,53 +0,0 @@
Ciertos usuarios de SPIP quizás quieran mostrar código informático en sus páginas. El atajo <HTML><TT>&lt;code&gt;...&lt;/code&gt;</TT></HTML> sirve para eso.
Ejemplo:<cadre> <code><?php // esto es lenguaje ph
echo "hola";
?></code>
</cadre>
nos da
<quote>
<code><?php // esto es lenguaje ph
echo "hola";
?></code>
</quote>
Existe otro atajo para publicar extractos de código informático en varias líneas:
<html><tt>&lt;cadre&gt;...&lt;/cadre&gt;</tt></html>. Esto sitúa el código en un «formulario» (esto se usa a menudo en la página actual). La ventaja de este método es que facilita mucho el copiar y pegar desde tu página Web: basta con situar el cursor dentro del código, y ejecutar «seleccionar todo» (alt-A) para poder copiar el código directamente. Además, con numerosos navegadores, este cuadro permite recuperar bien las tabulaciones del principio de línea.
Veamos un ejemplo:
<cadre>
class Texte {
var
type = 'texte';
var
texte;
}
class Champ {
var
type = 'champ';
var
nom_champ,
id_champ;
var
cond_avant,
cond_apres; // tablas de objetos
var
fonctions;
}
</cadre>
{{Saltarse los atajos de SPIP}}
En algunos casos, puede ser útil indicarle a SPIP que ciertas partes de un documento no deben ser «tratadas» por el filtro de los atajos tipográficos: no se quiere corregir la tipografía, se desea presentar código fuente (por ejemplo en PHP, JavaScript...), etc.
Es código de este atajo es:
<cadre><HTML>texto que no hay
que cambiar; [[¡cuidado!]]</HTML>
</cadre>»
que nos da:
<quote>
<HTML>texto que no hay que cambiar; [[¡cuidado!]]</HTML>
<quote>
(fíjate en que no se crea una nota. Si la página estuviese en francés, tampoco añadiría espacios imborrables antes del punto y coma, ni del signo de exclamación).

9
aide/es/raccourcis/glossaire.spip

@ -1,9 +0,0 @@
Por otra parte, se puede crear muy rápidamente un enlace de hipertexto hacia la definición de un término en un glosario externo; para un término dado, basta con insertar dentro de tu texto el atajo <code>[?término]</code>.
Así el siguiente código:
« <code>{En busca del tiempo perdido} es la principal obra de [?Marcel Proust]</code> »
quedará al publicarlo:
«{En busca del tiempo perdido} es la principal obra de [?Marcel Proust]».
Piensa en pulsar sobre el enlace para comprobar que el término introducido (nombre propio o nombre común) está escrito correctamente y que apunta a un destino válido.
El glosario externo predefinido es [Wikipedia->http://www.wikipedia.org]. Se trata de una enciclopedia multilingüe escrita de modo cooperativo, abierta a todas las colaboraciones a través de Internet. Toma tu tiempo para conocerla, respetarla y contribuir al enriquecimiento de este fondo de conocimiento compartido.

65
aide/es/raccourcis/lien.spip

@ -1,65 +0,0 @@
Un enlace hipertexto se crea fácilmente con el siguiente código:
<cadre>SPIP es una iniciativa del [minirézo->http://www.minirezo.net/].</cadre>
que se convierte en:
<quote>SPIP es una iniciativa del [minirézo->http://www.minirezo.net/].</quote>
(Mnemotécnica: un guión seguido por el signo «mayor que» crea una especie de fleche que indica que el texto del enlace (antes de la flecha) «apunta hacia» una dirección.)
La dirección del enlace puede ser una dirección absoluta (que comienza, como aquí, por <code>http://</code>), una dirección relativa (hacia otra página del mismo sitio), un enlace hacia un documento utilizando un protocolo de Internet (<code>ftp://</code>...), una dirección de email («<code>[->minirezo@rezo.net]</code>»)...
Aplicación específica: puedes mostrar el texto completo de un enlace en forma de dirección URL, si no escribes nada antes de la «flecha». Por ejemplo:
<cadre>[->http://dmoz.org/World/Deutsch/Kultur/Literatur/Autoren_und_Autorinnen/P/Proust,_Marcel/]</cadre>
muestra lo siguiente:
<quote>[->http://dmoz.org/World/Deutsch/Kultur/Literatur/Autoren_und_Autorinnen/P/Proust,_Marcel/]</quote>
Fíjate que, en el caso de las URL muy largas, se trunca su visualización (para evitar que se degrade tu interfaz gráfica); pero el enlace hipertexto apunta hacia la dirección buena.
[liensite<-]
- {{Enlaces de hipertexto hacia el interior del sitio}}
El propio sistema de enlaces de hipertexto facilita, además, la creación de enlaces hacia el interior de tu sitio bajo SPIP. La única sutileza consiste en buscar el {número} del artículo, de la sección, o de la noticia breve hacia la que quieres dirigir tu enlace de hipertexto:
<img src="AIDE/fr/articlenumero.gif" alt="NUMERO" border="0" align="right">
Cuando «visitas», en el espacio privado, un artículo, una breve o una rubrique, la columna de la izquierda contiene un bloque que indica este número en grandes caracteres.
Este es el número que tienes que indicar en el enlace de hipertexto:
-* Enlace hacia el artículo 342 (cuatro posibilidades):}
<HTML><TT>
<BR>enlace hacia [el artículo->342]
<BR>enlace hacia [el artículo->art342]
<BR>enlace hacia [el artículo->article 342]
<BR></tt></html>
Aplicación específica: <HTML><TT>[->art342]</tt></html> (sin indicar nada antes de la «flecha») mostrará automáticamente el título del artículo 342 con un enlace hacia ese artículo.
-* Enlace hacia la sección 12:}
<HTML><TT>
<BR>enlace hacia [la sección->rub12]
<BR>enlace hacia [la sección->rubrique 12]
</tt></html>
-* Enlace hacia la breve 65:}
<HTML><TT>
<BR>enlace hacia [la breve->br65]
<BR>enlace hacia [la breve->breve 65]
<BR>enlace hacia [la breve->brève 65]
</tt></html>
-* Autores, palabras clave, sitios, imágenes, documentos:}
<HTML><TT>
<BR>enlace hacia [un autor->aut13] o [ese mismo autor->auteur13]
<BR>enlace hacia [una palabra->mot32]
<BR>enlace hacia [un sitio sindicado->site1]
<BR>enlace hacia [un documento adjunto->doc17] o [ese mismo documento->document17]
<BR>enlace hacia [una imagen->img13] o [esa misma imagen->image13]
<BR>
</tt></html>
Aplicación específica: también aquí es posible no especificar nada antes de la «flecha»
(<html><tt>[->aut13]</tt></html>...).
SPIP insertará automáticamente la información necesaria. En el caso de un documento adjunto o de una imagen, si se le ha puesto manualmente un título, se mostrará este; si no, se usará el propio nombre del fichero.
<div align='right'>para saber más: <a href='#glossaire'>enlaces hacia un glosario</a>,
_ [anclas con nombre->#ancres].
</div>

36
aide/es/raccourcis/liste.spip

@ -1,36 +0,0 @@
Se pueden crear enumeraciones ramificadas añadiendo asteriscos tras el guión de enumeración.
Así:
<cadre>
-* Tu caballo es:
-** alazán;
-** bayo;
-** negro;
-* pero mi conejo es
-** blanco:
-*** de angora
-*** o de pelo corto.</cadre>
produce:
<quote>
-* Tu caballo es:
-** alazán;
-** bayo;
-** negro;
-* pero mi conejo es
-** blanco:
-*** de angora
-*** o de pelo corto.</quote>
- Para terminar, se pueden crear listas numeradas usando el carácter <code>#</code> en lugar del asterisco:
<cadre>
-# primero
-# segundo
-# tercero</cadre>
nos dará:
<quote>
-# primero
-# segundo
-# tercero</quote>

33
aide/es/raccourcis/note.spip

@ -1,33 +0,0 @@
Una nota de pie de página se marca, a menudo, con un número colocado dentro del texto, número repetido al final de la página para ofrecer un complemento a la información.
En SPIP, esta característica (bastante pesada de manejar manualmente en HTML) ha sido automatizada: las notas se numeran por SPIP, que igualmente gestiona los enlaces de hipertexto dentro del documento para pasar directamente desde la llamada de la nota al texto de la
nota correspondiente, y viceversa.
Une nota de pie de página, en SPIP, se marca entre corchetes dobles: «<HTML><TT>Una nota[[Esto es un complemento informativo.]] de pie de página.</TT></HTML>» se verá de esta forma: «Una nota[[Esto es un complemento informativo.]] de pie de página.»
<div align='right'><a href='#notes'>para saber más: notas no automáticas</a></div>
{{Las notas no automáticas}}
En la mayor parte de los casos, el sistema de notas automáticas señalado antes es ampliamente suficiente. No obstante, puedes gestionar las notas de manera no automática «forzando» la elección del número o del texto mostrado para realizar el enlace.
El principio general consiste en indicar tu elección del texto utilizado entre los signos «menor que» y «mayor que» al principio de la nota:
<cadre>Una nota «forzada»[[<xxx> El texto de la nota.]]</cadre>
Siguiendo este principio:
<cadre>puedes utilizar notas numeradas automáticamente[[Situando el texto de la nota entre corchetes.]],
- y también forzar la numeración de la nota[[<23> Indicando el número de la nota entre los símbolos «<» y «>».]],
- usar notas con forma de asterisco [[<*> Simplemente poniendo un asterisco entre los signos «<» y «>».]],
- crear notas sin referencia (sin numerar); cuidado, estas notas no tienen un enlace entre la nota y su llamada en el texto[[<> No escribiendo nada entre los símbolos «<» y «>».]],
- darle un nombre (todo en letra) a una nota; uso muy extendido para las referencias bibliográficas[[<Rab> François Rabelais.]];
- llamar a una nota ya existente[[<23>]] indicando el número de esa nota entre los símbolos «<» y «>». y dejando vacía el resto de la nota.</cadre>
produce:
<quote>puedes utilizar notas numeradas automáticamente[[Situando el texto de la nota entre corchetes.]],
- y también forzar la numeración de la nota[[<23> Indicando el número de la nota entre los símbolos «<» y «>».]],
- usar notas con forma de asterisco [[<*> Simplemente poniendo un asterisco entre los signos «<» y «>».]],
- crear notas sin referencia (sin numerar); cuidado, estas notas no tienen un enlace entre la nota y su llamada en el texto[[<> No escribiendo nada entre los símbolos «<» y «>».]],
- darle un nombre (todo en letra) a una nota; uso muy extendido para las referencias bibliográficas[[<Rab> François Rabelais.]];
- llamar a una nota ya existente[[<23>]] indicando el número de esa nota entre los símbolos «<» y «>». y dejando vacía el resto de la nota.</quote>

55
aide/es/raccourcis/resume.spip

@ -1,55 +0,0 @@
<pre><code class="language-spip_typo">
{{Un intertítulo}}
Texto con {cursiva } y {{negrita}} o una {{combinación de las dos}}.
Un salto de línea con [un enlace externo->https://www.spip.net] y [un enlace interno->art12] con un título automático [->rubrique10].
Otro párrafo con [[Una nota a pie de página]] y un término del [?glosario].
-* Una lista
-* Una lista
-** Elemento de la sublista
-# Una lista ordenada
-# Una lista ordenada
-## Elemento de lista ordenada subordinada
Trazo de separación horizontal
----
Una tabla
| {{ Lieu }} | {{ Action }} |
| Les grottes | Spip Party |
| Toulouse | Spip en rose |
La definición de un ancla [directo<-] con un enlace para ir allí [->#directo].
<cita>Una cita</cita>
</code></pre>
{{Un intertítulo}}
Texto con {cursiva } y {{negrita}} o una {{combinación de las dos}}.
Un salto de línea con [un enlace externo->https://www.spip.net] y [un enlace interno->art12] con un título automático [->rubrique10].
Otro párrafo con [[Una nota a pie de página]] y un término del [?glosario].
-* Una lista
-* Una lista
-** Elemento de la sublista
-# Una lista ordenada
-# Una lista ordenada
-## Elemento de lista ordenada subordinada
Trazo de separación horizontal
----
Una tabla
| {{ Lieu }} | {{ Action }} |
| Les grottes | Spip Party |
| Toulouse | Spip en rose |
La definición de un ancla [directo<-] con un enlace para ir allí [->#directo].
<cita>Una cita</cita>

57
aide/es/raccourcis/simple.spip

@ -1,57 +0,0 @@
SPIP respeta automáticamente las principales reglas de espaciado de la tipografía francesa. Así, se añaden espacios imborrables antes de los caracteres
«:», «;», «!», «?»~-,
y sitúa espacios imborrables antes y después de las comillas «tipográficas».
(Nota: esta característica sólo se activa en los sitios cuyo idioma principal sea el francés.)
{{Crear párrafos}}
Para crear párrafos, es suficiente dejar una línea vacía, un poco como se separan los párrafos en un email (se «salta» una línea).
Un simple «salto de línea» (retorno de carro) sin separar los dos párrafos con una línea vacía no basta para causar un cambio de párrafo.
Se pueden dejar varias líneas vacías seguidas sin que ello modifique la presentación.
{{Crear listas o enumeraciones}}
En SPIP se pueden fabricar listas de la misma manera que en un email: basta con cambiar de línea y comenzar la línea nueva con un guión («-»).
Nota: aquí basta con un simple salto de línea (se pueden hacer enumeraciones dentro del mismo párrafo); pero si se «salta» una línea antes de la que comienza con un guión, se mostrará una línea vacía antes de la enumeración.
Por ejemplo, <cadre>- Qu'est-ce que cela peut faire que je lutte pour la mauvaise cause
puisque je suis de bonne foi?
- Et qu'est-ce que ça peut faire que je sois de mauvaise foi
puisque c'est pour la bonne cause. (Jacques
Prévert)</cadre>
se verá así:
<quote>
- Qu'est-ce que cela peut faire que je lutte pour la mauvaise cause puisque je suis de bonne foi?
- Et qu'est-ce que ça peut faire que je sois de mauvaise foi
puisque c'est pour la bonne cause. (Jacques Prévert)
</quote>
<div align='right'><a href='#listes'>más información acerca de las listas</a></div>
Tenga en cuenta que se trata de insertar una {viñeta} y no de crear una lista ([más información acerca de las listas->#listas])
{{Negrita y cursiva}}
El texto {en cursiva} se indica sencillamente situándolo entre llaves simples: «<HTML><TT>...un texto {en cursiva} en...</TT></HTML>».
El texto {{en negrita}} se indica poniéndolo entre llaves dobles: «<HTML><TT>...un texto {{en negrita}} en...</TT></HTML>».
{{Intertítulos}}
Los intertítulos son los títulos situados en el interior de un texto para indicar la estructura. En SPIP, se indica muy fácilmente situándolo entre llaves triples: «<HTML><TT>{{{El título de una parte}}}</tt></html>» mostrará el texto en negrita y centrado:
<quote>{{{El título de una parte}}}</quote>
- {{Trazo de separación horizontal}}
Es muy fácil insertar una línea horizontal de separación con toda la longitud del texto: basta con situar una línea que sólo contenga una sucesión de al menos cuatro guiones, así:
<cadre>----</cadre>
lo que nos da:
<quote>
----
</quote>

63
aide/es/raccourcis/tableau.spip

@ -1,63 +0,0 @@
Para realizar tablas muy simples con SPIP, puedes crear líneas con las «casillas» separadas por el símbolo «<HTML>|</HTML>» ({pipe}, un trazo vertical), y que comienzan y terminan con trazos verticales. Es obligatorio dejar líneas vacías antes y después de la tabla.
Por ejemplo, la tabla:
| {{Apellido}} | {{Nombre}} | {{Edad}} |
| Marso | Ben | 23 años |
| Capitana | | desconocida |
| Philant | Philippe | 46 años |
| Cadoc | Bebé | 4 meses |
se codifica así:
<cadre>
| {{Apellido}} | {{Nombre}} | {{Edad}} |
| Marso | Ben | 23 años |
| Capitana | | desconocida |
| Philant | Philippe | 46 años |
| Cadoc | Bebé | 4 meses |
</cadre>
Fíjate en que todas las entradas de la primera línea están en negrita. SPIP identifica así que se trata de una línea de encabezado, y le atribuye una presentación distinta de las demás líneas (fondo de diferente color). La presencia de una línea como esa no es obligatoria.
También puede añadir una leyenda y un resumen a la tabla. Estos dos datos son opcionales, pero son muy importantes para que la tabla sea accesible a los discapacitados visuales, ya que el resumen da una mejor idea del contenido de la tabla.
Esta información se especifica entre líneas verticales dobles antes de la tabla, así:
<cadre>
||Leyenda|Resumen||
| {{Nombre}} |{Fecha de nacimiento}} |{Ciudad}} |
| Jacques | 5/10/1970 | Paris |
| Claire | 12/2/1975 | Belfort |
| Martin | 1/31/1957 | Nice |
| Marie | 23/12/1948 | Perpignan |
</cadre>
y aparecerá así:
||Leyenda|Resumen||
| {{Nombre}} |{Fecha de nacimiento}} |{Ciudad}} |
| Jacques | 5/10/1970 | Paris |
| Claire | 12/2/1975 | Belfort |
| Martin | 1/31/1957 | Nice |
| Marie | 23/12/1948 | Perpignan |
Es posible no especificar ninguna de las informaciones, pero es importante recordar que hay que poner una simple línea vertical delante del resumen si sólo se especifica éste: <code>|| | resumen ||</code>
También es posible fusionar una caja con otras, reduciendo su contenido a <code>|<|</code> para fusionarla con la caja que la precede horizontalmente; o a <code>|^|</code> para fusionarla con la caja que la precede verticalmente.
<cadre>
||Tableau avec fusion| Raccourci de fusion||
| {{columna 1}} | {{columna 2}} | {{columna 3}} |
| Ligne 1 | L1C2 et L1C3 |<|
| Ligne 2 | L2C2 et L3C2|L2C3|
| Ligne 3 |^| L3C3 |
</cadre>
donnera
||Tabla con fusión| Atajo de fusión|||
| {{columna 1}} | {{columna 2}} | {{columna 3}} |
| Ligne 1 | L1C2 et L1C3 |<|
| Ligne 2 | L2C2 et L3C2|L2C3|
| Ligne 3 |^| L3C3 |

7
aide/fr/raccourcis/_intro.spip

@ -1,7 +0,0 @@
<!-- ig br -->
{{Pour faciliter la mise en page des documents publiés avec SPIP, le système propose un certain nombre de «raccourcis SPIP» destinés:
- à simplifier l'utilisation par des utilisateurs ne connaissant pas le HTML;
- à faciliter le traitement automatique de la mise en page.}}
Par conséquent naturellement vous pouvez toujours utiliser le code HTML dans vos documents SPIP, mais nous vous conseillons d'utiliser de préférence ces quelques raccourcis SPIP (peu nombreux), qui sont beaucoup plus faciles à mémoriser et plus particulièrement permettent au système certaines opérations automatisées.}}

8
aide/fr/raccourcis/ancre.spip

@ -1,8 +0,0 @@
<!-- ig br -->
Vous pouvez définir des «ancres HTML» afin de pouvoir construire un lien direct vers un point donné au milieu d'une page d'un site SPIP. Il suffit d'introduire le raccourci:
<cadre>[direct<-]</cadre>
et cela créera une ancre de nom <code>direct</code>. Ainsi, s'il s'agit, par exemple, de l'article 3723, l'URL <code>http://monsite/spip.php?page=article.php&id_article=3723#direct</code> conduira directement à l'endroit de l'article où est situé cette ancre.
Il est à noter que les ancres sont compatibles avec les [liens hypertexte à l'intérieur du site->#liensite]. Ainsi, le raccourci «<code>[ce point précis->art123#precis]</code>» conduira vers l'ancre nommée «<code>precis</code>» défini dans l'article 123.

20
aide/fr/raccourcis/citation.spip

@ -1,20 +0,0 @@
<!-- ig br -->
Il est souvent pratique, dans un forum de discussion, de citer un extrait du message auquel on
est en train de répondre. Pour homogénéiser la présentation de telles citations, SPIP propose le raccourci
<html><tt>&lt;quote>...&lt;/quote></tt></html>.
Par exemple:
<cadre>
<quote>C'est drôlement bien, SPIP.</quote>
Kikou, je suis bien d'accord :-)
</cadre>
donne:
<quote><quote>C'est drôlement bien, SPIP.</quote>
Kikou, je suis bien d'accord :-)</quote>

65
aide/fr/raccourcis/code.spip

@ -1,65 +0,0 @@
<!-- ig br -->
Certains utilisateurs de SPIP veulent parfois afficher du code informatique dans leurs pages.
Le raccourci <HTML><TT>&lt;code>...&lt;/code></TT></HTML> est là pour ça.
Exemple : <cadre> <code><?php // ceci est du langage php
echo "bonjour";
</code>