ส่วนขยาย:CharInsert

MediaWiki extensions manual

CharInsert Release status: stable
Implementation	Tag , Page action , MyWiki
Description	อนุญาตให้สร้างกล่องแทรกอักขระ JavaScript
Author(s)	Brion Vibber (Brooke Vibberคุย)
Latest version	continuous updates
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review
Tags ‎<charinsert>
Hooks used BeforePageDisplay ParserFirstCallInit
Quarterly downloads	70 (Ranked 71st)
Public wikis using	9,224 (Ranked 15th)
Translate the CharInsert extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

ส่วนขยาย CharInsert อนุญาตให้สร้างลิงก์ JavaScript ที่เมื่อคลิกแล้ว ให้แทรกข้อความที่กำหนดไว้ล่วงหน้าลงใน กล่องข้อความ

ลิงก์เหล่านี้มักใช้ในข้อความระบบ MediaWiki:Edittools (ตัวอย่างในวิกินี้)

Syntax

ใช้แท็ก ‎<charinsert> พร้อมรายการ characters ที่คั่นด้วยช่องว่างหรือแท็กที่คุณต้องการอนุญาตให้แทรก

คุณสามารถใช้ + ลงชื่อเข้าใช้ในแท็กเพื่อกำหนดสถานที่สำหรับ:

• แทรกข้อความที่เลือก หรือ
• วางเคอร์เซอร์หากไม่มีการเลือกข้อความ

คุณต้องใส่แม่แบบและช่องว่างภายใน ‎<nowiki>:

<charinsert><nowiki>== + ==</nowiki> <nowiki>{{stub}}</nowiki></charinsert>

การใช้งานและเอาต์พุตตัวอย่าง

อักขระแต่ละตัว

อักขระแต่ละตัวอยู่ระหว่างแท็ก "charinsert" เท่านั้น

<charinsert>Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź</charinsert>

ผลลัพธ์ใน

Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź

การคลิกลิงก์จะไม่มีผลใด ๆ เนื่องจากไม่มีการป้อนข้อมูลหรือช่องแก้ไข

อักขระรวม

อักขระที่รวมกันอยู่ระหว่างแท็ก "charinsert" และเชื่อมต่อด้วยเครื่องหมาย "+"

<charinsert>“+” ‘+’ «+» ‹+› „+“ ‚+‘ [[+]] {{+}}</charinsert>

ผลลัพธ์ใน

“” ‘’ «» ‹› „“ ‚‘ [[]] {{}}

การคลิกลิงก์จะไม่มีผลใด ๆ เนื่องจากไม่มีการป้อนข้อมูลหรือช่องแก้ไข

Overriding display text

เวอร์ชันมีเดียวิกิ:

≥ 1.38 Gerrit change 748823

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

<charinsert label="Latin A">A</charinsert> <charinsert label="Cyrillic А">А</charinsert> <charinsert label="Greek Alpha">Α</charinsert>

results in

Latin A Cyrillic А Greek Alpha

Clicking the links will have no effect since there is no input or edit field.

หมายเหตุ

• ลิงก์ JavaScript ที่สร้างยังทำงานในพื้นที่อื่น ๆ รอบหน้าต่างแก้ไข เช่น ใน MediaWiki:Copyrightwarning หรือ MediaWiki:Newarticletext บนหน้าที่โหลดไว้ล่วงหน้าด้วย Inputbox และแม้กระทั่งจากการแสดงตัวอย่างข้อความ
• นอกจากนี้ยังสามารถใช้เป็น MediaWiki:Uploadtext เพื่อแทรกแม่แบบคำอธิบายรูปภาพ
• ส่วนขยายนี้ไม่มีวิธีการระบุ "ข้อความตัวอย่าง" ที่แทรก ซึ่งแตกต่างจากปุ่มบนแถบเครื่องมือที่ด้านบน
• ใช้ 
 เพื่อเพิ่มบรรทัดใหม่ (\n)
• ใส่ช่องว่างสีขาวในแท็ก ‎<nowiki>...‎</nowiki> เมื่อจำเป็น
• เพิ่มแท็ก ‎<charinsert>...‎</charinsert> เป็น MediaWiki:Edittools

การติดตั้ง

• ดาวน์โหลดและวางไฟล์ลงในไดเร็กทอรีที่ชื่อ CharInsert ในโฟลเดอร์ extensions/ ของคุณ
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CharInsert
• เพิ่มโค้ดต่อไปนี้ไว้ที่ด้านล่างของ LocalSettings.php ของคุณ:

  wfLoadExtension( 'CharInsert' );
  

• หากคุณใช้ gadget Edittools ให้อัปเดตโค้ดเป็น เวอร์ชันล่าสุด (≥ 27 พฤษภาคม 2016)
•  สำเร็จ – ตรวจสอบที่ Special:Version บนวิกิของคุณเพื่อตรวจการติดตั้งส่วนขยาย

การติดตั้งขั้นสูง

สื่งสำคัญ: คุณจำเป็นต้องมี ส่วนขยาย:อุปกรณ์เสริม จึงจะใช้งานได้

จัดแต่งรูปแบบ

หากต้องการให้ charinsert แสดงรายการสไตล์เพิ่มเติม ให้รวบรวมเนื้อหาของ Edittools ของคุณระหว่าง <div class="mw-charinsert-buttons"> ถึง ‎</div> และเพิ่มสไตล์สำหรับ MediaWiki:Common.css ของคุณ ไซต์นี้ (www.mediawiki.org) ทำเพื่อให้ลิงก์ปรากฏเป็นปุ่ม (ดังแสดงในภาพหน้าจอด้านข้าง) ใช้สไตล์ชีตด้านล่างสำหรับสิ่งนั้น คัดลอกไปที่ MediaWiki:Common.css ของคุณเพื่อใช้สไตล์เดียวกัน

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]]
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	border: 1px solid #aaa;
	margin-top: 10px;
	padding: 1px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #cde !important;
	color: #000;
	border: thin #069 outset;
	padding: 0 1px 1px;
	font-weight: bold;
	font-size: 0.9em;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover,
.mw-charinsert-buttons a:active {
	background-color: #bcd;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	font-size: 0.9em;
	margin-left: 1px;
	padding-left: 1px;
	padding-right: 1px;
}

หรือคุณสามารถเลือกรูปแบบที่ใกล้เคียงกับ Wikimedia Design Style Guide และ WikimediaUI theme:

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]] in WikimediaUI inspired theme.
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	margin-top: 8px;
	border: 1px solid #c8ccd1;
	padding: 2px 4px 4px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #f8f9fa !important;
	color: #202122;
	border: thin #36c outset;
	padding: 0 1px 2px;
	font-size: 0.9em;
	font-weight: bold;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover {
	background-color: #fff;
    color: #404244;
}

.mw-charinsert-buttons a:active {
	background-color: #c8ccd1;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	background-color: #f8f9fa;
	color: #202122;
	margin-left: 1px;
    border-radius: 2px;
	padding: 1px 6px;
	font-size: 0.9em;
    /* Apply pointer cursor to all interactive elements. */
    cursor: pointer;
}

.client-js .mw-edittools-section input[type="button"]:hover {
	background-color: #fff;
    color: #404244;
}

.client-js .mw-edittools-section input[type="button"]:active {
	background-color: #c8ccd1;
    color: #000;
}

Scripting

หากคุณมีลิงก์ CharInsert หลายลิงก์ คุณสามารถใช้ JavaScript เพื่อจัดกลุ่มแยกกันและอนุญาตให้มีการสลับแบบไดนามิกด้วยเมนูดรอปดาวน์ ตัวอย่างเช่น การแยกอักขระกำกับเสียงออกจาก wikisyntax เป็นต้น ไซต์หลายแห่ง (เช่น mediawiki.org, de.wikipedia.org และ en.wikipedia.org) ได้ดำเนินการส่วนนี้แล้ว พวกเขาทั้งหมดนำไปใช้ในหลากหลายรูปแบบ เอกสารด้านล่างนี้เป็นวิธีที่ทำการสร้างใน mediawiki.org:

1. ห่อแท็ก charinsert ทั้งหมดบน MediaWiki:Edittools ลงในคอนเทนเนอร์ ‎<div> และระบุ ID ที่สื่อความหมายและไม่ซ้ำ (เช่น "mw-edittools-charinsert"):

<div id="mw-edittools-charinsert" class="mw-charinsert-buttons" title="Click on the wanted special character.">
...
</div>

2. จัดการแต่ละบล็อกของ charinserts เป็น ‎<p> แท็กดังนี้:

<p class="mw-edittools-section" data-section-title="Wiki-Syntax" style="display: none;">
...
</p>

 หมายเหตุ:

• อย่าเปลี่ยนแปลงคำ 'mw-edittools-section'
• ข้อความที่อยู่เบื้องหลัง "data-section-title=" จะระบุกลุ่มนี้ในเมนูแบบดรอปดาวน์
• ตรวจสอบให้แน่ใจว่ามีกลุ่มหนึ่งที่ไม่มีคำสั่ง 'style="display: none;"' ซึ่งจะเป็นตัวเลือกเริ่มต้นในเมนูดรอปดาวน์ บนไซต์นี้ เรียกว่า 'มาตรฐาน' ในขณะที่กลุ่มอื่น ๆ ถูกตั้งชื่อตามภาษาที่อักขระมีความสำคัญ

3. คัดลอกเนื้อหา MediaWiki:Gadget-Edittools.js ไปยังหน้าที่มีชื่อเทียบเท่าในโครงการวิกิของคุณเอง

4. เพิ่มรหัสต่อไปนี้ใน MediaWiki:Gadgets-definition ของคุณ:

* Edittools[ResourceLoader|default]|Edittools.js

เมนู CharInsert วิกิพีเดียภาษาอังกฤษ

สำหรับการนำเมนู CharInsert ไปใช้เหมือนกับที่ใช้ในวิกิพีเดียภาษาอังกฤษ ให้ส่งออกแกดเจ็ต: Charinsert-core, Charinsert-styles และ Charinsert แล้วนำเข้าบนวิกิของคุณเองจนถึง Special:Import หรือหากคุณต้องการทำด้วยตนเอง ให้คัดลอกสี่รายการต่อไปนี้ หน้าส่วนต่อประสานกับวิกิของคุณ:

• MediaWiki:Gadget-charinsert-core.js (Wikipedia) - ไฟล์ JavaScript หลัก
• MediaWiki:Gadget-charinsert-styles.css (Wikipedia) - สร้างกล่องรอบ ๆ สัญลักษณ์/อักขระให้มีลักษณะเหมือนปุ่ม
• MediaWiki:Gadget-charinsert.js (Wikipedia) - CharInsert loader
• MediaWiki:Gadget-charinsert (Wikipedia) - สำหรับข้อความที่แสดงในการตั้งค่าผู้ใช้' ส่วนแกดเจ็ต

• ใน MediaWiki:Gadgets-definition ของคุณ ให้เพิ่มคำจำกัดความต่อไปนี้:

  * 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) - สำหรับผู้ใช้ที่ปิด JavaScript หรือไม่ได้รับการสนับสนุนเท่านั้น (ซึ่งปิดใช้งานส่วนขยาย WikiEditor ด้วย) ดังนั้นจึงไม่จำเป็นหรือมีประโยชน์จริง ๆ โดยจะแสดงเฉพาะสัญลักษณ์/อักขระเป็นข้อความธรรมดาด้านล่างหน้าต่างตัวแก้ไข ซึ่งสามารถคัดลอกและวางได้ จึงเป็นประโยชน์ต่อบรรณาธิการ เห็นได้ชัดว่า มันไม่ได้เปิดใช้งานในวิกิพีเดียภาษาอังกฤษสำหรับ JavaScript ที่ปิดใช้งาน

 หมายเหตุ: ชุดอักขระวิกิพีเดียภาษาอังกฤษโดยเฉพาะนี้ยังมีแม่แบบ ซึ่งจะต้องกำหนดแยกต่างหาก หากจะใช้บนโครงการวิกิของคุณ

ตรวจสอบวิธีแก้ปัญหาวิกิพีเดียภาษาอังกฤษเมื่อ: 6 พฤศจิกายน 2018