Extension:CharInsert/ar

يسمح امتداد CharInsert بإنشاء وصلات جافا سكريبت تدرج حينما ينقر عليها نص محدد سلفا في صندوق النصوص.

تستخدم هذه الوصلات عادة في رسالة النظام MediaWiki:Edittools (مثال على موقع الويكي هذا).

القواعد اللغوية
استخدم وسوم مع قائمة محارف أو وسوم مقسمة باستخدام مسافات  التي ترغب في السماح بإدراجها.

يمكنك استخدام علامة + داخل أي وسم كي تحدد مكان ما يلي:


 * إدراج نص محدد أو
 * وضع المؤشر لو لم يقع الاختيار على نص.

سيتعين عليك أن تحيط القوالب المساحات داخل كما يلي:

محارف منفردة
المحارف المنفردة مدرجة بين وسوم «charinsert».

ونتيجتها هي

محارف مجمعة
المحارف المجمّعة مدرجة بين وسوم «charinsert» وتوصل باستخدام العلامة «+».

ونتيجتها هي

Overriding display text
A different display text can be specified in the  attribute (if you use this, you should use separate   tags for each character in order to specify different display texts).

results in

ملاحظات

 * Generated JavaScript links also work in other areas around edit window, e.g. in MediaWiki:Copyrightwarning or MediaWiki:Newarticletext, on the page preloaded with, and even from the text preview.
 * They can also be used in MediaWiki:Uploadtext to insert image description templates.
 * Unlike toolbar buttons on top, this extension doesn't provide a way to specify inserted "sample text".
 * Use  to add new lines (\n).
 * Enclose white spaces in  tags when needed.
 * Add  tags into MediaWiki:Edittools.

تنصيب متقدم
ملحوظة هامة: You must have for this to work.

الأسلوب


To give the charinsert lists additional styling, wrap the contents of your Edittools between  and  and add styling for them to your. This site (www.mediawiki.org) does that to make the links appear like buttons (as shown in the screenshot to the side). The below stylesheet was used for that, copy it to your to apply the same styling.

Alternatively, you can choose a style closer to the Wikimedia Design Style Guide and the WikimediaUI theme:

كتابة النص البرمجي
If you have many CharInsert links, one could use JavaScript to put them in separate groups and allow dynamic switching with a dropdown menu. For example to separate diacritical characters from wikisyntax etc. Several sites (such as mediawiki.org, de.wikipedia.org and en.wikipedia.org) have done this. They all implemented it in different ways though. Documented below is the way it is done on mediawiki.org:

1. Wrap all the charinsert tags on MediaWiki:Edittools into a container and give it a descriptive, unique, ID (for example "mw-edittools-charinsert") :
 * 2. Wrap each individual block of charinserts into tags like this:


 * Note:
 * Don't change the word 'mw-edittools-section'
 * The text behind "data-section-title=" will identify this group in the dropdown menu.
 * Make sure there is one group without the ' ' directive: That will be the default choice in the dropdown menu. On this site, it is called 'Standard' while the other groups are named by the language for which the characters are significant.
 * 3. Copy the contents of MediaWiki:Gadget-Edittools.js to an equally named page on your own wiki
 * 4. Add the following code to your :


 * Edittools[ResourceLoader|default]|Edittools.js

قائمة إدراج محارف ويكيبيديا الإنكليزية
For implementing CharInsert menu like the one used on the English Wikipedia, either export gadgets: Charinsert-core, Charinsert-styles, and Charinsert and then import them on your own wiki through Special:Import or if you want to do it manually, copy the following four interface pages to your wiki:


 * MediaWiki:Gadget-charinsert-core.js (Wikipedia) - Main JavaScript file.
 * MediaWiki:Gadget-charinsert-styles.css (Wikipedia) - Creates surrounding boxes around the symbols/characters giving them the look of buttons.
 * MediaWiki:Gadget-charinsert.js (Wikipedia) - CharInsert loader.
 * MediaWiki:Gadget-charinsert (Wikipedia) - For the text shown in user preferences' gadgets section.

Note: This particular English Wikipedia character set also contains templates, which will need to be defined separately, if they are to be used on your Wiki.
 * In your MediaWiki:Gadgets-definition, add the following definitions:
 * charinsert[ResourceLoader|default|peers=charinsert-styles]|charinsert.js
 * charinsert-core[ResourceLoader|hidden|dependencies=jquery.textSelection,user,mediawiki.storage]|charinsert-core.js
 * charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css
 * MediaWiki:Edittools (Wikipedia) - Only for users with JavaScript turned off or unsupported (which disables the WikiEditor extension too), therefore not really necessary or useful either. It only shows symbols/characters as simple text below the editor window, which can then be copy-pasted and thus be of some help to editors. Apparently, it does not get activated in English Wikipedia for disabled JavaScript.

 English Wikipedia Solution checked on: November 6, 2018