פיצול סרגל הניווט לקטעים חדשים

ניתן לפצל את סרגל הניווט למקטעים, שלכל אחד כותרת חדשה משלו. זה נעשה על ידי הוספת כוכבית אחת.

הכותרת של כל מקטע נלקחת מאלמנט הרשימה ברמה הראשונה ("ניווט" ו"כותרת חדשה" בדוגמה לעיל). אם טקסט זה תואם לשם של הודעת ממשק (דף קיים של כותרת זו במרחב השמות של מדיה-ויקי), אז הטקסט של דף זה ישמש כתווית; אחרת, הכותרת העליונה משמשת כפי שהיא. שימו לב שמילת הקסם {{int:}} אינה פועלת מכיוון שהיא חסרת תועלת: מדיה-ויקי מחפשת אוטומטית תרגום להצגה לפני שהיא חוזרת להודעה המוגדרת כברירת מחדל.

בדוגמה לעיל, * navigation ו-* new heading הן כותרות של מקטעים.

יצירת קישורים בסרגל הצד

קישורים נוצרים באמצעות שתי כוכביות (הנקראות אלמנטים של רשימה ברמה השנייה). לדוגמה:

** יעד|טקסט קישור

יעד

יעד הקישור יכול להיות שם של הודעת ממשק (דף במרחב השמות של מדיה-ויקי) או דף ויקי, או קישור חיצוני. בכל מקרה, הקישור יכול להיות פנימי, בין-ויקי או חיצוני.^[2]

בצעו את הפעולות הבאות כדי לקבוע את היעד:

1. קבל את טקסט היעד.
2. אם קיימת הודעת ממשק קיימת או ברירת מחדל עם שם זה, יש להשתמש בתוכן ההודעה במקום בטקסט היעד.
3. אם הפלט מהשלב הקודם הוא כתובת URL חוקית (שמתחילה ב-http:// או בפרוטוקול URL אחר), הקישור יפנה לכתובת URL זו.
4. אחרת, הוא יתייחס אליו כקישור יעד של קישור ויקי (המקשר לשם דף זה או קישור בין-ויקי).
5. במקרה שזה יקשר ל--, כל הערך יוסר מסרגל הצד. (זה שימושי להסרת ערך בכל השפות על ידי שינוי ההודעה שמכילה את הקישור).

דוגמאות:

• "** portal-url|portal" – משתמש בטקסט של MediaWiki:Portal-url (אשר מכיל "Project:Community portal").
• "** https://www.mediawiki.org|MediaWiki home" – מקשר ל-https://www.mediawiki.org מכיוון שזוהי כתובת URL חוקית.
• "** Special:RecentChanges|Recent changes" – מקשר ל-Special:RecentChanges, מכיוון שאין הודעת ממשק בשם זה וזו אינה כתובת URL תקפה.
• "** w:Foo|Some interwiki page" – מקשר ל-w:Foo מאותה סיבה.

טקסט קישור

טקסט הקישור יכול להיות שם של הודעת ממשק (דף במרחב השמות של מדיה-ויקי) או טקסט רגיל.

• אם טקסט הקישור הוא שם של הודעת ממשק קיימת או ברירת מחדל, תוכן ההודעה ייעשה בו שימוש. מדיה-ויקי תבדוק אם יש גרסאות מתורגמות; לדוגמה, אם השפה הנוכחית היא fr (צרפתית) וטקסט הקישור הוא הודעת הממשק "forum", הוא יבדוק "forum/fr" לפני השימוש ב-"forum".
• אחרת, טקסט הקישור משמש כיעד כפי שהוא.
• שימו לב שטקסט הקישור אינו אופציונלי כמו בקישורי ויקי רגילים. אם טקסט הקישור חסר, הוא יתעלם מהפריט.

דוגמאות:

• ** Homepage|mainpage – משתמש ב-MediaWiki:Mainpage (שמכיל "MediaWiki").
• ** Special:Recentchanges|Recent changes – משתמש ב-"Recent changes", מכיוון שאין הודעת ממשק בשם זה.

Special:MyLanguage/Help:Links#Interlanguage_links | helplinks

סדר מקטעים (אלמנטים)

חלק מערכות העיצובים מאפשרים התאמה אישית של הסדר של אלמנטים מיוחדים, כמו סרגל החיפוש, ארגז הכלים והשפות. ניתן לעשות זאת על ידי הוספת מילות המפתח המיוחדות SEARCH, TOOLBOX, LANGUAGES בהתאמה, ל- MediaWiki:Sidebar באמצעות תחביר הכותרת.

עם זאת, חלק מערכות העיצובים כמו MonoBook אינם תומכים עוד בהגדרת מיקום אלמנט החיפוש, ואלמנט החיפוש ממוקם במקום זאת מיד לאחר החלק הראשון של סרגל הצד. במקרה כזה, כדי להזיז את רכיב החיפוש למעלה, הפתרון הוא להגדיר מקטע מוביל ריק. לדוגמה:

* empty section
* navigation
** mainpage|mainpage
** Special:Recentchanges|Recent changed
* new heading
** portal-url|portal
** https://www.mediawiki.org|MediaWiki home

שימו לב שחלק מערכות העיצובים עשויים להציג את החלק הראשון בצורה שונה, או למקם אלמנט כלשהו בין החלק הראשון לשני (אם קיים).

תיאורי כלים ומפתח גישה

תיאור כלי (או הסבר) הוא הודעה המופיעה כאשר סמן ממוקם מעל סמל, תמונה, היפר-קישור או אלמנט אחר בממשק משתמש גרפי.

אם תוסיף פריט לסרגל הצד, לא יהיה לו "הסבר". אך ניתן ליצור הסבר על ידי ביצוע הפעולות הבאות: ^[3]

• צור דף ויקי בשם MediaWiki:Tooltip-n-<מזהה הפריט>

• והכנס את תיאור הכלי לדף הזה.

מקש גישה או accesskey מאפשר למשתמש מחשב לקפוץ באופן מיידי לחלק מסוים בדף אינטרנט באמצעות המקלדת.

ניתן גם ליצור מקשי גישה על ידי ביצוע הפעולות הבאות:

• צור דף ויקי בשם MediaWiki:Accesskey-n-<מזהה הפריט>
• והכנס את מקש הגישה לדף זה.

דוגמה:

• * Homepage|mainpage-description - משתמש ב-MediaWiki:Tooltip-n-mainpage-description וב-MediaWiki:Accesskey-n-mainpage-description.

הסר את סרגל הצד ואת הלוגו הראשי ב-MediaWiki:Sidebar

כדי להסיר לחלוטין את סרגל הצד והלוגו:

רוקן את הדף של MediaWiki:Sidebar ושמור.

לאחר מכן הוסף:

#column-content { margin: 0 0 1em 0; }
#content { margin: 0 0 0 0; }
#p-cactions { left: .1em; }

פעולה זו מזיזה את הטקסט הראשי של דף הויקי שלך שמאלה.

הסר לחלוטין את סרגל הצד, הכרטיסיות וסרגל החיפוש

מוחק את הלוגו ואת כל סרגל הצד:

#p-logo, .generated-sidebar, #p-lang, #p-tb  { display:none; }

מוחק את סרגל החיפוש:

#p-search { display:none; }

מוחק את כרטיסיית השיחה:

#ca-talk { display:none!important; }

מוחק את כרטיסיית הדף:

#ca-nstab-main { display:none!important; }

לאלץ את הודעות ממשק המשתמש לעקוב אחר תוכן

חלק מהדפים צריכים לפעמים לעקוב אחר שפת התוכן, במיוחד עבור אתרים רב-לשוניים. ניתן לשלוט בכך באמצעות ההגדרה $wgForceUIMsgAsContentMsg . כל הודעה שנדרסת בדרך זו חייבת להיות ניתנת במפורש, לדוגמה כדי לאפשר לסרגל הצד לקשר לגרסאות שניתנו על ידי שפת התוכן עבור הדף הראשי ולדף הפורטל להוסיף את הפרטים הבאים ל-

LocalSettings.php

code

$wgForceUIMsgAsContentMsg = [ 'mainpage', 'portal-url' ];

הוספה או הסרה של מקטעי ארגז הכלים

ארגז הכלים מופיע בצד שמאל מתחת ל-MediaWiki:Sidebar בערכות עיצובים מסוימים. ב-Vector 2022 הוא מופיע בצד ימין של המסך (בשפות משמאל לימין LTR).

החל ממדיה-ויקי 1.43 ניתן להוסיף קישורים לארגז הכלים באמצעות MediaWiki:Sidebar דרך MediaWiki:Sidebar.

* empty section
* navigation
* TOOLBOX
** portal-url|Forum

function ModifySidebar( action, section, name, link ) {
	try {
		switch ( section ) {
			case 'languages':
				var target = 'p-lang';
				break;
			case 'toolbox':
				var target = 'p-tb';
				break;
			case 'navigation':
				var target = 'p-navigation';
				break;
			default:
				var target = 'p-' + section;
				break;
		}

		if ( action == 'add' ) {
			var node = document.getElementById( target )
							   .getElementsByTagName( 'div' )[0]
							   .getElementsByTagName( 'ul' )[0];

			var aNode = document.createElement( 'a' );
			var liNode = document.createElement( 'li' );

			aNode.appendChild( document.createTextNode( name ) );
			aNode.setAttribute( 'href', link );
			liNode.appendChild( aNode );
			liNode.className = 'plainlinks';
			node.appendChild( liNode );
		}

		if ( action == 'remove' ) {
			var list = document.getElementById( target )
							   .getElementsByTagName( 'div' )[0]
							   .getElementsByTagName( 'ul' )[0];

			var listelements = list.getElementsByTagName( 'li' );

			for ( var i = 0; i < listelements.length; i++ ) {
				if (
					listelements[i].getElementsByTagName( 'a' )[0].innerHTML == name ||
					listelements[i].getElementsByTagName( 'a' )[0].href == link
				)
				{
					list.removeChild( listelements[i] );
				}
			}
		}


	} catch( e ) {
		// בואו פשוט נתעלם ממה שקרה
		return;
	}
}

function CustomizeModificationsOfSidebar() {
	// מוסיף [[Special:CategoryTree|Special:CategoryTree]] לארגז הכלים
	ModifySidebar( 'add', 'toolbox', 'CategoryTree', 'https://en.wikipedia.org/wiki/Special:CategoryTree' );
	// מסיר [[Special:Upload|Special:Upload]] מארגז הכלים
	ModifySidebar( 'remove', 'toolbox', 'Upload file', 'https://en.wikipedia.org/wiki/Special:Upload' );
}

jQuery( CustomizeModificationsOfSidebar );

jQuery( CustomizeModificationsOfSidebar );

if ( mw.config.get( 'wgUserGroups', [] ).indexOf( 'bureaucrat' ) !== -1 ) {
	jQuery( CustomizeModificationsOfSidebar );
}

if ( mw.config.get( 'wgUserGroups', [] ).indexOf( 'user' ) === -1 ) {
	jQuery( CustomizeModificationsOfSidebar );
}

הוספה או הסרה של מקטעי ארגז הכלים (PHP)

אתה יכול להוסיף לקובץ שלך LocalSettings.php את ההוק המתואר בדף זה. בעזרת זה, ניתן לשנות באמצעות MediaWiki:Sidebar את הקישורים בחלונית ארגז הכלים (להסיר קישורים מסוימים, לשנות את שמם) ולהוסיף קישורים מותאמים אישית (למשל, להוסיף את הקישור "Recent changes" שם במקום בחלונית הניווט).

יצירת סרגל צד מתרחב/מתכווץ עבור כל המשתמשים (רק בעיצוב Monobook)

אם אתם משתמשים בערכת העיצוב של Monobook ולא רוצים לפספס את סרגל התפריטים הניתן להרחבה, למשל מערכת העיצוב של Vector, הדביקו את הקוד הבא לתוך MediaWiki:Monobook.js של דף הויקי שלכם.

/////////////////////////////////////////////////////////
// קטע קוד שיאפשר להרחבה של פריטי סרגל הצד. 
// השתמשו בקוד זה רק עבור ערכת העיצוב של Monobook. 
/////////////////////////////////////////////////////////

$( document ).ready( function() {
	// הגדר את הפריטים המורחבים כברירת מחדל לפי הכותרת שלהם
	var defaultExpandItems = ['Navigation', 'Orga'];
	// הגדר את השם הבסיסי לעוגיות, אשר שומרים את המצב הנוכחי של התרחבות
	var expandCookieName = 'disdance_project_wiki_nav_expanded_';

var maxHeights = [];
	var expandeds = [];
	var labels = [];
	initNav();
});

function initNav() {
	$( '#p-logo' ).css({'position': 'relative', 'display': 'block'});
	$( '.generated-sidebar h5,#p-tb h5 ').each( function( i ) {
		var id = $( this ).parent().attr( 'id' );
		maxHeights[id] = $( this ).next( 'div' ).height();
		var str = $( this ).html();
		labels[id] = str;

if ( $.cookie( expandCookieName + id ) == 'false' ) {
			expandeds[id] = false;
			minimize( $( this ) );
		} else if ( $.cookie( expandCookieName + id ) == 'true' ) {
			expandeds[id] = true;
			maximize( $( this ) );
		} else if ( defaultExpandItems.indexOf( str ) == -1 ) {
			expandeds[id] = false;
			minimize( $( this ) );
		} else {
			expandeds[id] = true;
			maximize( $( this ) );
		}
		$( this ).css({'cursor': 'pointer'});
		$( this ).click( toggleNav );
	} );
}

function minimize( target ) {
	var id = $( target ).parent().attr( 'id' );
	// ניתן לשנות את הפרמטר expires כדי לשמור את העוגייה למשך זמן ארוך/קצר יותר מ-7 ימים כמו בקוד הזה.
	$.cookie( expandCookieName + id, 'false', { expires: 7} );
	var str = labels[id] + '  ►';
	$( target ).next( 'div' ).animate({'height': '0px'});
	$( target ).html( str );
}

function maximize( target ) {
	var id = $( target ).parent().attr( 'id' );
	// ניתן לשנות את הפרמטר expires כדי לשמור את העוגייה למשך זמן ארוך/קצר יותר מ-7 ימים כמו בקוד הזה.
	$.cookie( expandCookieName + id, 'true', { expires: 7} );
	var str = labels[id] + '  ▼';
	var newHeight = maxHeights[id];
	$( target ).next( 'div' ).animate({'height': newHeight + 'px'});
	$( target ).html( str );
}

function toggleNav( e ) {
	var id = $(e.target ).parent().attr( 'id' );
	expandeds[id] = !expandeds[id];
	if( expandeds[id] == true ) {
		maximize( e.target );
	} else {
		minimize( e.target );
	}
}

///////////////////////////////////////////////////////
///////////////////////////////////////////////////////

רוחב סרגל צד בערכת העיצוב Monobook (CSS)

ניתן לשנות את רוחב סרגל הצד על ידי הוספת כללי ה-CSS הבאים עבור ה-MediaWiki:Monobook.css שלכם

שימו לב שזהו ערך, לא קובץ. פעולה זו משנה את הרוחב ל-15em, מיקום הפעולות ורוחב הפורטלט צריכים להיות פחות מ-em, לכן הגדרתי אותם ל-14em בדוגמה זו.

/* הגדלת רוחב סרגל הצד */
#column-content { margin-left: -15em; }
#column-content #content { margin-left: 15em; }
#p-logo a, #p-logo a:hover { width: 15em; }
#p-cactions { left: 14.5em; }
.portlet { width: 14em; }
#column-content { margin-left: -14em; }
#content.mw-body { margin-left: 14em; }

שינוי תוכן סרגל הצד בעת כניסה (PHP)

התקן והגדר את ההרחבה DynamicSidebar .

פונקציות ניתוח בסרגל הצד

למרות שזה לא בדיוק מומלץ, סרגל הצד כן תומך בפונקציות ניתוח (כגון ParserFunctions ), בתנאי ש-** נמצא מחוץ לפונקציית הניתוח, ופונקציית הניתוח אינה משתרעת על פני מספר שורות. לדוגמה:

*Heading
**{{#ifeq:{{NAMESPACE}}|User|Page-to-link-to{{!}}text-to-show-on-user-page}}
**{{#ifeq:{{NAMESPACE}}|Talk|Another-Page-to-link-to{{!}}text-to-show-on-talk-page}}

עובד. עם זאת, הדברים הבאים לא יעבדו מכיוון שפונקציית הניתוח משתרעת על פני מספר שורות:

*Heading
{{#ifeq:1|1|
**foo{{!}}
bar
|
**baz{{!}}fred
}}

שינויים לא מופיעים

מדיה-ויקי שומרת תוכן במטמון באופן אגרסיבי במידת האפשר, מה שלעתים קרובות גורם לסרגל הניווט להישאר לאחר שינויים. ניקוי המטמון של הדפים המושפעים אמור לתקן את המצב. כדי לבצע ניקוי המוני של כל המטמונים בבת אחת, גע בקובץ LocalSettings.php או חתוך את הטבלה objectcache במסד הנתונים שלך (ייתכן שתצטרך לעשות את שניהם).

אתה צריך גם להגדיר $wgUseDatabaseMessages ל-true. כמו כן, אם הקישורים שלך לא מכילים את האות |, הם לא יופיעו בגלל שורת הקוד הזו ב-Skin.php: if ( strpos( $line, '|' ) !== false ) {

אם אתם משתמשים או מפעילי ויקי ממוצעים, לא תוכלו לבצע את הדברים המתקדמים לעיל כדי להציג את השינויים. אם גם הסרת השינויים לא עובדת, לעיתים עדיין תוכלו לראות שינויי CSS מיד בתצוגה המקדימה (במיוחד בעת שינוי ה-CSS האישי שלכם). לדוגמה; שינוי רוחב סרגל הצד, הריפוד או השוליים. עם זאת, ייתכן שיחלוף זמן מה עד שהשינויים יופיעו לאחר השמירה. אם לא מופיע דבר לאחר זמן מה, ייתכן שתצטרכו ליצור קשר עם מפעיל מערכת הויקי הכולל, או עם חוות הויקי.

תוויות קישור באותיות קטנות

אם הקישורים שלך אינם מופיעים באותיות גדולות כמתוכנן, נסה להוסיף רווחים מסביב לתו הסרגל; לדוגמה:

** http://www.example.com/download.php?file=44555 | הורדה

מדורים נעלמים או מציגים תוכן בלתי צפוי

אם מקטע אינו מציג או מציג תוכן בלתי צפוי, בדוק שטקסט הכותרת אינו שם של הודעת ממשק על ידי חיפוש ‎Special:AllMessages. אם כן, השתמש בטקסט כותרת שונה, או צור הודעת ממשק חדשה והשתמש בה.

לדוגמה, אם ברצונך להשתמש ב-"Sidebar" כטקסט כותרת, צור את הודעת הממשק "MediaWiki:Sidebar-header" המכילה רק "Sidebar". לאחר מכן, השתמש ב-* sidebar-header ככותרת.

מדורים לא מוצגים אם אין קישורים בצורת ** target | טקסט קישור (למשל, כאשר היעד נשכח).

קישורים שבורים לאחר עדכון Special:Version

זה יקרה למשל, בכל פעם שיהיו תרגומים חדשים יותר לפריטי סרגל הצד בשפת האתר שלך.

אפשר להוסיף דפי הפניה חדשים בכל פעם, אבל פתרון טוב יותר יהיה להשתמש בשמות פריטי סרגל הצד של עצמך במקום לנסות לעקוב אחר התרגומים הנוכחיים של מדיה-ויקי.