CINXE.COM

Typographical Guidelines - KDE UserBase Wiki

<!DOCTYPE html> <html class="client-nojs vector-feature-language-in-header-enabled vector-feature-language-in-main-page-header-disabled vector-feature-sticky-header-disabled vector-feature-page-tools-pinned-disabled vector-feature-toc-pinned-clientpref-1 vector-feature-main-menu-pinned-disabled vector-feature-limited-width-clientpref-1 vector-feature-limited-width-content-enabled vector-feature-zebra-design-disabled vector-feature-custom-font-size-clientpref-disabled vector-feature-client-preferences-disabled vector-feature-typography-survey-disabled vector-toc-available" lang="en" dir="ltr"> <head> <meta charset="UTF-8"> <title>Typographical Guidelines - KDE UserBase Wiki</title> <script>(function(){var className="client-js vector-feature-language-in-header-enabled vector-feature-language-in-main-page-header-disabled vector-feature-sticky-header-disabled vector-feature-page-tools-pinned-disabled vector-feature-toc-pinned-clientpref-1 vector-feature-main-menu-pinned-disabled vector-feature-limited-width-clientpref-1 vector-feature-limited-width-content-enabled vector-feature-zebra-design-disabled vector-feature-custom-font-size-clientpref-disabled vector-feature-client-preferences-disabled vector-feature-typography-survey-disabled vector-toc-available";var cookie=document.cookie.match(/(?:^|; )userbasemwclientpreferences=([^;]+)/);if(cookie){cookie[1].split('%2C').forEach(function(pref){className=className.replace(new RegExp('(^| )'+pref.replace(/-clientpref-\w+$|[^\w-]+/g,'')+'-clientpref-\\w+( |$)'),'$1'+pref+'$2');});}document.documentElement.className=className;}());RLCONF={"wgBreakFrames":true,"wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""], "wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgRequestId":"b8f6ab7c2d2bdce684eb97eb","wgCanonicalNamespace":"","wgCanonicalSpecialPageName":false,"wgNamespaceNumber":0,"wgPageName":"Typographical_Guidelines","wgTitle":"Typographical Guidelines","wgCurRevisionId":494128,"wgRevisionId":494128,"wgArticleId":7898,"wgIsArticle":true,"wgIsRedirect":false,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Contributing"],"wgPageViewLanguage":"en","wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgRelevantPageName":"Typographical_Guidelines","wgRelevantArticleId":7898,"wgIsProbablyEditable":false,"wgRelevantPageIsProbablyEditable":false,"wgRestrictionEdit":[],"wgRestrictionMove":[],"wgULSAcceptLanguageList":[],"wgULSCurrentAutonym":"English","wgInternalRedirectTargetUrl":"/Typographical_Guidelines","wgTranslatePageTranslation":"source", "wgULSPosition":"personal","wgULSisCompactLinksEnabled":true,"wgULSisLanguageSelectorEmpty":false};RLSTATE={"skins.vector.user.styles":"ready","site.styles":"ready","user.styles":"ready","skins.vector.user":"ready","user":"ready","user.options":"loading","ext.translate":"ready","ext.translate.tag.languages":"ready","ext.pygments":"ready","codex-search-styles":"ready","skins.vector.styles":"ready","skins.vector.icons":"ready","ext.translate.edit.documentation.styles":"ready","ext.uls.pt":"ready","ext.embedVideo.styles":"ready"};RLPAGEMODULES=["mediawiki.action.view.redirect","site","mediawiki.page.ready","mediawiki.toc","skins.vector.js","ext.uls.compactlinks","ext.uls.interface","ext.embedVideo.overlay"];</script> <script>(RLQ=window.RLQ||[]).push(function(){mw.loader.impl(function(){return["user.options@12s5i",function($,jQuery,require,module){mw.user.tokens.set({"patrolToken":"+\\","watchToken":"+\\","csrfToken":"+\\"}); }];});});</script> <link rel="stylesheet" href="/load.php?lang=en&amp;modules=codex-search-styles%7Cext.embedVideo.styles%7Cext.pygments%2Ctranslate%7Cext.translate.edit.documentation.styles%7Cext.translate.tag.languages%7Cext.uls.pt%7Cskins.vector.icons%2Cstyles&amp;only=styles&amp;skin=vector-2022"> <script async="" src="/load.php?lang=en&amp;modules=startup&amp;only=scripts&amp;raw=1&amp;skin=vector-2022"></script> <meta name="ResourceLoaderDynamicStyles" content=""> <link rel="stylesheet" href="/load.php?lang=en&amp;modules=site.styles&amp;only=styles&amp;skin=vector-2022"> <meta name="generator" content="MediaWiki 1.41.4"> <meta name="robots" content="max-image-preview:standard"> <meta name="format-detection" content="telephone=no"> <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes, minimum-scale=0.25, maximum-scale=5.0"> <link rel="apple-touch-icon" href="https://www.kde.org/aether/media/180x180.png"> <link rel="icon" href="https://www.kde.org/aether/media/192x192.png"> <link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="KDE UserBase Wiki (en)"> <link rel="EditURI" type="application/rsd+xml" href="https://userbase.kde.org/api.php?action=rsd"> <link rel="license" href="/KDE_UserBase_Wiki:Copyrights"> <link rel="alternate" type="application/atom+xml" title="KDE UserBase Wiki Atom feed" href="/index.php?title=Special:RecentChanges&amp;feed=atom"> </head> <body class="skin-vector skin-vector-search-vue mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-0 ns-subject page-Typographical_Guidelines rootpage-Typographical_Guidelines skin-vector-2022 action-view skin--responsive"><a class="mw-jump-link" href="#bodyContent">Jump to content</a> <div class="vector-header-container"> <header class="vector-header mw-header"> <div class="vector-header-start"> <nav class="vector-main-menu-landmark" aria-label="Site" role="navigation"> <div id="vector-main-menu-dropdown" class="vector-dropdown vector-main-menu-dropdown vector-button-flush-left vector-button-flush-right" > <input type="checkbox" id="vector-main-menu-dropdown-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-main-menu-dropdown" class="vector-dropdown-checkbox " aria-label="Main menu" > <label id="vector-main-menu-dropdown-label" for="vector-main-menu-dropdown-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only " aria-hidden="true" ><span class="vector-icon mw-ui-icon-menu mw-ui-icon-wikimedia-menu"></span> <span class="vector-dropdown-label-text">Main menu</span> </label> <div class="vector-dropdown-content"> <div id="vector-main-menu-unpinned-container" class="vector-unpinned-container"> <div id="vector-main-menu" class="vector-main-menu vector-pinnable-element"> <div class="vector-pinnable-header vector-main-menu-pinnable-header vector-pinnable-header-unpinned" data-feature-name="main-menu-pinned" data-pinnable-element-id="vector-main-menu" data-pinned-container-id="vector-main-menu-pinned-container" data-unpinned-container-id="vector-main-menu-unpinned-container" > <div class="vector-pinnable-header-label">Main menu</div> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-pin-button" data-event-name="pinnable-header.vector-main-menu.pin">move to sidebar</button> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-unpin-button" data-event-name="pinnable-header.vector-main-menu.unpin">hide</button> </div> <div id="p-Navigation" class="vector-menu mw-portlet mw-portlet-Navigation" > <div class="vector-menu-heading"> Navigation </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="n-ub-home" class="mw-list-item"><a href="/Special:MyLanguage/Welcome_to_KDE_UserBase"><span>Home</span></a></li><li id="n-ub-start-contributing" class="mw-list-item"><a href="/Special:MyLanguage/Introduction_to_new_contributors"><span>Quick Start</span></a></li><li id="n-recentchanges" class="mw-list-item"><a href="/Special:RecentChanges" title="A list of recent changes in the wiki [r]" accesskey="r"><span>Recent changes</span></a></li> </ul> </div> </div> <div id="p-ub-contributors" class="vector-menu mw-portlet mw-portlet-ub-contributors" > <div class="vector-menu-heading"> Contributors </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="n-ub-helpfiles" class="mw-list-item"><a href="/Special:MyLanguage/Tasks_and_Tools"><span>Start Contributing</span></a></li><li id="n-ub-helpfiles-modify" class="mw-list-item"><a href="/Ub-helpfiles-modify-redirect"><span>Modify Existing Pages</span></a></li><li id="n-ub-helpfiles-new-content" class="mw-list-item"><a href="/Ub-helpfiles-new-content-redirect"><span>Add New Pages</span></a></li><li id="n-ub-helpfiles-typographical-guidelines" class="mw-list-item"><a href="/Special:MyLanguage/Typographical_Guidelines"><span>Display elements markup</span></a></li><li id="n-ub-helpfiles-markup" class="mw-list-item"><a href="/Special:MyLanguage/Toolbox"><span>More Markup Help</span></a></li> </ul> </div> </div> <div id="p-ub-translators" class="vector-menu mw-portlet mw-portlet-ub-translators" > <div class="vector-menu-heading"> Translators </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="n-ub-get-trans-account" class="mw-list-item"><a href="/Special:MyLanguage/Translator_Account"><span>Get a Translator Account</span></a></li><li id="n-ub-languages-represented" class="mw-list-item"><a href="/Special:ActiveLanguages"><span>Languages represented</span></a></li><li id="n-ub-helpfiles-languages" class="mw-list-item"><a href="/Ub-helpfiles-languages-redirect"><span>Working with Languages</span></a></li><li id="n-ub-trans-tool" class="mw-list-item"><a href="/Special:LanguageStats"><span>Start Translating</span></a></li><li id="n-ub-release-request" class="mw-list-item"><a href="/ReadyForTranslation"><span>Request Release</span></a></li> </ul> </div> </div> <div class="vector-main-menu-action vector-main-menu-action-lang-alert vector-main-menu-action-lang-alert-empty"> <div class="vector-main-menu-action-item"> <div class="vector-main-menu-action-heading vector-menu-heading">Languages</div> <div class="vector-main-menu-action-content vector-menu-content"> <div class="mw-message-box cdx-message cdx-message--block mw-message-box-notice cdx-message--notice vector-language-sidebar-alert"><span class="cdx-message__icon"></span><div class="cdx-message__content">Language links are at the top of the page across from the title.</div></div> </div> </div> </div> </div> </div> </div> </div> </nav> <a href="/Welcome_to_KDE_UserBase" class="mw-logo"> <span class="mw-logo-container"> <img class="mw-logo-wordmark" alt="KDE UserBase Wiki" src="/images/kde-logo-white-blue-source.svg" style="width: 2em; height: 2em;"> </span> </a> </div> <div class="vector-header-end"> <div id="p-search" role="search" class="vector-search-box-vue vector-search-box-collapses vector-search-box-show-thumbnail vector-search-box-auto-expand-width vector-search-box"> <a href="/Special:Search" class="cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only search-toggle" id="" title="Search KDE UserBase Wiki [f]" accesskey="f"><span class="vector-icon mw-ui-icon-search mw-ui-icon-wikimedia-search"></span> <span>Search</span> </a> <div class="vector-typeahead-search-container"> <div class="cdx-typeahead-search cdx-typeahead-search--show-thumbnail cdx-typeahead-search--auto-expand-width"> <form action="/index.php" id="searchform" class="cdx-search-input cdx-search-input--has-end-button"> <div id="simpleSearch" class="cdx-search-input__input-wrapper" data-search-loc="header-moved"> <div class="cdx-text-input cdx-text-input--has-start-icon"> <input class="cdx-text-input__input" type="search" name="search" placeholder="Search KDE UserBase Wiki" aria-label="Search KDE UserBase Wiki" autocapitalize="sentences" title="Search KDE UserBase Wiki [f]" accesskey="f" id="searchInput" > <span class="cdx-text-input__icon cdx-text-input__start-icon"></span> </div> <input type="hidden" name="title" value="Special:Search"> </div> <button class="cdx-button cdx-search-input__end-button">Search</button> </form> </div> </div> </div> <nav class="vector-user-links" aria-label="Personal tools" role="navigation" > <div id="p-vector-user-menu-overflow" class="vector-menu mw-portlet mw-portlet-vector-user-menu-overflow" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="ca-uls" class="user-links-collapsible-item mw-list-item active"><a href="#" class="uls-trigger cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet"><span class="vector-icon mw-ui-icon-wikimedia-language mw-ui-icon-wikimedia-wikimedia-language"></span> <span>English</span></a></li><li id="pt-login-2" class="user-links-collapsible-item mw-list-item"><a href="/index.php?title=Special:UserLogin&amp;returnto=Typographical+Guidelines" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o"><span>Log in</span></a></li> </ul> </div> </div> <div id="vector-user-links-dropdown" class="vector-dropdown vector-user-menu vector-button-flush-right vector-user-menu-logged-out" title="More options" > <input type="checkbox" id="vector-user-links-dropdown-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-user-links-dropdown" class="vector-dropdown-checkbox " aria-label="Personal tools" > <label id="vector-user-links-dropdown-label" for="vector-user-links-dropdown-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only " aria-hidden="true" ><span class="vector-icon mw-ui-icon-ellipsis mw-ui-icon-wikimedia-ellipsis"></span> <span class="vector-dropdown-label-text">Personal tools</span> </label> <div class="vector-dropdown-content"> <div id="p-personal" class="vector-menu mw-portlet mw-portlet-personal" title="User menu" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="pt-login" class="user-links-collapsible-item mw-list-item"><a href="/index.php?title=Special:UserLogin&amp;returnto=Typographical+Guidelines" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o"><span class="vector-icon mw-ui-icon-logIn mw-ui-icon-wikimedia-logIn"></span> <span>Log in</span></a></li> </ul> </div> </div> </div> </div> </nav> </div> </header> </div> <div class="mw-page-container"> <div class="mw-page-container-inner"> <div class="vector-sitenotice-container"> <div id="siteNotice"></div> </div> <div class="vector-main-menu-container"> <div id="mw-navigation"> <nav id="mw-panel" class="vector-main-menu-landmark" aria-label="Site" role="navigation"> <div id="vector-main-menu-pinned-container" class="vector-pinned-container"> </div> </nav> </div> </div> <input type="checkbox" id="vector-toc-collapsed-checkbox" class="vector-menu-checkbox"> <nav id="mw-panel-toc" role="navigation" aria-label="Contents" data-event-name="ui.sidebar-toc" class="mw-table-of-contents-container vector-toc-landmark vector-sticky-pinned-container"> <div id="vector-toc-pinned-container" class="vector-pinned-container"> <div id="vector-toc" class="vector-toc vector-pinnable-element"> <div class="vector-pinnable-header vector-toc-pinnable-header vector-pinnable-header-pinned" data-feature-name="toc-pinned" data-pinnable-element-id="vector-toc" > <h2 class="vector-pinnable-header-label">Contents</h2> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-pin-button" data-event-name="pinnable-header.vector-toc.pin">move to sidebar</button> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-unpin-button" data-event-name="pinnable-header.vector-toc.unpin">hide</button> </div> <ul class="vector-toc-contents" id="mw-panel-toc-list"> <li id="toc-mw-content-text" class="vector-toc-list-item vector-toc-level-1"> <a href="#" class="vector-toc-link"> <div class="vector-toc-text">Beginning</div> </a> </li> <li id="toc-Links" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Links"> <div class="vector-toc-text"> <span class="vector-toc-numb">1</span>Links</div> </a> <ul id="toc-Links-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Bold_Text" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Bold_Text"> <div class="vector-toc-text"> <span class="vector-toc-numb">2</span>Bold Text</div> </a> <ul id="toc-Bold_Text-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Italic_Text" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Italic_Text"> <div class="vector-toc-text"> <span class="vector-toc-numb">3</span>Italic Text</div> </a> <ul id="toc-Italic_Text-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Combined_Bold_and_Italic_Text" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Combined_Bold_and_Italic_Text"> <div class="vector-toc-text"> <span class="vector-toc-numb">4</span>Combined Bold and Italic Text</div> </a> <ul id="toc-Combined_Bold_and_Italic_Text-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Mono-spaced_Text" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Mono-spaced_Text"> <div class="vector-toc-text"> <span class="vector-toc-numb">5</span>Mono-spaced Text</div> </a> <ul id="toc-Mono-spaced_Text-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Block_Quotes" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Block_Quotes"> <div class="vector-toc-text"> <span class="vector-toc-numb">6</span>Block Quotes</div> </a> <ul id="toc-Block_Quotes-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Text_in_Section_Headers" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Text_in_Section_Headers"> <div class="vector-toc-text"> <span class="vector-toc-numb">7</span>Text in Section Headers</div> </a> <ul id="toc-Text_in_Section_Headers-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Text_in_Information,_Note,_Tip_or_Warning_Templates" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Text_in_Information,_Note,_Tip_or_Warning_Templates"> <div class="vector-toc-text"> <span class="vector-toc-numb">8</span>Text in Information, Note, Tip or Warning Templates</div> </a> <ul id="toc-Text_in_Information,_Note,_Tip_or_Warning_Templates-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Lists" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Lists"> <div class="vector-toc-text"> <span class="vector-toc-numb">9</span>Lists</div> </a> <ul id="toc-Lists-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Keeping_things_together" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Keeping_things_together"> <div class="vector-toc-text"> <span class="vector-toc-numb">10</span>Keeping things together</div> </a> <ul id="toc-Keeping_things_together-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Unbalanced_brackets" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Unbalanced_brackets"> <div class="vector-toc-text"> <span class="vector-toc-numb">11</span>Unbalanced brackets</div> </a> <ul id="toc-Unbalanced_brackets-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Special_Tags" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Special_Tags"> <div class="vector-toc-text"> <span class="vector-toc-numb">12</span>Special Tags</div> </a> <button aria-controls="toc-Special_Tags-sublist" class="cdx-button cdx-button--weight-quiet cdx-button--icon-only vector-toc-toggle"> <span class="vector-icon vector-icon--x-small mw-ui-icon-wikimedia-expand"></span> <span>Toggle Special Tags subsection</span> </button> <ul id="toc-Special_Tags-sublist" class="vector-toc-list"> <li id="toc-Key_presses_and_menu_selections" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#Key_presses_and_menu_selections"> <div class="vector-toc-text"> <span class="vector-toc-numb">12.1</span>Key presses and menu selections</div> </a> <ul id="toc-Key_presses_and_menu_selections-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Files_and_file_paths" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#Files_and_file_paths"> <div class="vector-toc-text"> <span class="vector-toc-numb">12.2</span>Files and file paths</div> </a> <ul id="toc-Files_and_file_paths-sublist" class="vector-toc-list"> </ul> </li> </ul> </li> <li id="toc-The_Problematic_Pipe" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#The_Problematic_Pipe"> <div class="vector-toc-text"> <span class="vector-toc-numb">13</span>The Problematic Pipe</div> </a> <ul id="toc-The_Problematic_Pipe-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Translatable_Content" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Translatable_Content"> <div class="vector-toc-text"> <span class="vector-toc-numb">14</span>Translatable Content</div> </a> <ul id="toc-Translatable_Content-sublist" class="vector-toc-list"> </ul> </li> </ul> </div> </div> </nav> <div class="mw-content-container"> <main id="content" class="mw-body" role="main"> <header class="mw-body-header vector-page-titlebar"> <label id="vector-toc-collapsed-button" class="cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet vector-button-flush-left cdx-button--icon-only" for="vector-toc-collapsed-checkbox" role="button" aria-controls="vector-toc" tabindex="0" title="Table of Contents"> <span class="vector-icon mw-ui-icon-wikimedia-listBullet"></span> <span>Toggle the table of contents</span> </label> <nav role="navigation" aria-label="Contents" class="vector-toc-landmark"> <div id="vector-page-titlebar-toc" class="vector-dropdown vector-page-titlebar-toc vector-button-flush-left" > <input type="checkbox" id="vector-page-titlebar-toc-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-page-titlebar-toc" class="vector-dropdown-checkbox " aria-label="Toggle the table of contents" > <label id="vector-page-titlebar-toc-label" for="vector-page-titlebar-toc-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only " aria-hidden="true" ><span class="vector-icon mw-ui-icon-listBullet mw-ui-icon-wikimedia-listBullet"></span> <span class="vector-dropdown-label-text">Toggle the table of contents</span> </label> <div class="vector-dropdown-content"> <div id="vector-page-titlebar-toc-unpinned-container" class="vector-unpinned-container"> </div> </div> </div> </nav> <h1 id="firstHeading" class="firstHeading mw-first-heading"><span class="mw-page-title-main">Typographical Guidelines</span></h1> </header> <div class="vector-page-toolbar"> <div class="vector-page-toolbar-container"> <div id="left-navigation"> <nav aria-label="Namespaces"> <div id="p-associated-pages" class="vector-menu vector-menu-tabs mw-portlet mw-portlet-associated-pages" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="ca-nstab-main" class="selected vector-tab-noicon mw-list-item"><a href="/Typographical_Guidelines" title="View the content page [c]" accesskey="c"><span>Page</span></a></li><li id="ca-talk" class="vector-tab-noicon mw-list-item"><a href="/Talk:Typographical_Guidelines" rel="discussion" title="Discussion about the content page [t]" accesskey="t"><span>Discussion</span></a></li> </ul> </div> </div> <div id="p-variants" class="vector-dropdown emptyPortlet" > <input type="checkbox" id="p-variants-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-p-variants" class="vector-dropdown-checkbox " aria-label="Change language variant" > <label id="p-variants-label" for="p-variants-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet" aria-hidden="true" ><span class="vector-dropdown-label-text">English</span> </label> <div class="vector-dropdown-content"> <div id="p-variants" class="vector-menu mw-portlet mw-portlet-variants emptyPortlet" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> </ul> </div> </div> </div> </div> </nav> </div> <div id="right-navigation" class="vector-collapsible"> <nav aria-label="Views"> <div id="p-views" class="vector-menu vector-menu-tabs mw-portlet mw-portlet-views" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="ca-view" class="selected vector-tab-noicon mw-list-item"><a href="/Typographical_Guidelines"><span>Read</span></a></li><li id="ca-viewsource" class="vector-tab-noicon mw-list-item"><a href="/index.php?title=Typographical_Guidelines&amp;action=edit" title="This page is protected.&#10;You can view its source [e]" accesskey="e"><span>View source</span></a></li><li id="ca-history" class="vector-tab-noicon mw-list-item"><a href="/index.php?title=Typographical_Guidelines&amp;action=history" title="Past revisions of this page [h]" accesskey="h"><span>View history</span></a></li> </ul> </div> </div> </nav> <nav class="vector-page-tools-landmark" aria-label="Page tools"> <div id="vector-page-tools-dropdown" class="vector-dropdown vector-page-tools-dropdown" > <input type="checkbox" id="vector-page-tools-dropdown-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-page-tools-dropdown" class="vector-dropdown-checkbox " aria-label="Tools" > <label id="vector-page-tools-dropdown-label" for="vector-page-tools-dropdown-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet" aria-hidden="true" ><span class="vector-dropdown-label-text">Tools</span> </label> <div class="vector-dropdown-content"> <div id="vector-page-tools-unpinned-container" class="vector-unpinned-container"> <div id="vector-page-tools" class="vector-page-tools vector-pinnable-element"> <div class="vector-pinnable-header vector-page-tools-pinnable-header vector-pinnable-header-unpinned" data-feature-name="page-tools-pinned" data-pinnable-element-id="vector-page-tools" data-pinned-container-id="vector-page-tools-pinned-container" data-unpinned-container-id="vector-page-tools-unpinned-container" > <div class="vector-pinnable-header-label">Tools</div> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-pin-button" data-event-name="pinnable-header.vector-page-tools.pin">move to sidebar</button> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-unpin-button" data-event-name="pinnable-header.vector-page-tools.unpin">hide</button> </div> <div id="p-cactions" class="vector-menu mw-portlet mw-portlet-cactions emptyPortlet vector-has-collapsible-items" title="More options" > <div class="vector-menu-heading"> Actions </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="ca-more-view" class="selected vector-more-collapsible-item mw-list-item"><a href="/Typographical_Guidelines"><span>Read</span></a></li><li id="ca-more-viewsource" class="vector-more-collapsible-item mw-list-item"><a href="/index.php?title=Typographical_Guidelines&amp;action=edit"><span>View source</span></a></li><li id="ca-more-history" class="vector-more-collapsible-item mw-list-item"><a href="/index.php?title=Typographical_Guidelines&amp;action=history"><span>View history</span></a></li> </ul> </div> </div> <div id="p-tb" class="vector-menu mw-portlet mw-portlet-tb" > <div class="vector-menu-heading"> General </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="t-whatlinkshere" class="mw-list-item"><a href="/Special:WhatLinksHere/Typographical_Guidelines" title="A list of all wiki pages that link here [j]" accesskey="j"><span>What links here</span></a></li><li id="t-recentchangeslinked" class="mw-list-item"><a href="/Special:RecentChangesLinked/Typographical_Guidelines" rel="nofollow" title="Recent changes in pages linked from this page [k]" accesskey="k"><span>Related changes</span></a></li><li id="t-specialpages" class="mw-list-item"><a href="/Special:SpecialPages" title="A list of all special pages [q]" accesskey="q"><span>Special pages</span></a></li><li id="t-print" class="mw-list-item"><a href="javascript:print();" rel="alternate" title="Printable version of this page [p]" accesskey="p"><span>Printable version</span></a></li><li id="t-permalink" class="mw-list-item"><a href="/index.php?title=Typographical_Guidelines&amp;oldid=494128" title="Permanent link to this revision of this page"><span>Permanent link</span></a></li><li id="t-info" class="mw-list-item"><a href="/index.php?title=Typographical_Guidelines&amp;action=info" title="More information about this page"><span>Page information</span></a></li> </ul> </div> </div> </div> </div> </div> </div> </nav> </div> </div> </div> <div class="vector-column-end"> <nav class="vector-page-tools-landmark vector-sticky-pinned-container" aria-label="Page tools"> <div id="vector-page-tools-pinned-container" class="vector-pinned-container"> </div> </nav> </div> <div id="bodyContent" class="vector-body" aria-labelledby="firstHeading" data-mw-ve-target-container> <div class="vector-body-before-content"> <div class="mw-indicators"> </div> <div id="siteSub" class="noprint">From KDE UserBase Wiki</div> </div> <div id="contentSub"><div id="mw-content-subtitle"></div></div> <div id="mw-content-text" class="mw-body-content mw-content-ltr" lang="en" dir="ltr"><div class="mw-parser-output"><div class="mw-pt-languages noprint" lang="en" dir="ltr"><div class="mw-pt-languages-label">Other languages:</div><ul class="mw-pt-languages-list"><li><span class="mw-pt-languages-ui mw-pt-languages-selected mw-pt-progress mw-pt-progress--complete" lang="en" dir="ltr">English</span></li> <li><a href="/Typographical_Guidelines/lb" class="mw-pt-progress mw-pt-progress--stub" title="Typografesch Richtlinnen (6% translated)" lang="lb" dir="ltr">Lëtzebuergesch</a></li> <li><a href="/Typographical_Guidelines/ca" class="mw-pt-progress mw-pt-progress--high" title="Directrius tipogràfiques (69% translated)" lang="ca" dir="ltr">català</a></li> <li><a href="/Typographical_Guidelines/da" class="mw-pt-progress mw-pt-progress--complete" title="Typografiske retningslinjer (88% translated)" lang="da" dir="ltr">dansk</a></li> <li><a href="/Typographical_Guidelines/fr" class="mw-pt-progress mw-pt-progress--complete" title="Règles Typographiques (88% translated)" lang="fr" dir="ltr">français</a></li> <li><a href="/Typographical_Guidelines/it" class="mw-pt-progress mw-pt-progress--low" title="Linee guida tipografiche (32% translated)" lang="it" dir="ltr">italiano</a></li> <li><a href="/Typographical_Guidelines/ru" class="mw-pt-progress mw-pt-progress--stub" title="Руководство по форматированию (3% translated)" lang="ru" dir="ltr">русский</a></li> <li><a href="/Typographical_Guidelines/uk" class="mw-pt-progress mw-pt-progress--complete" title="Настанови з форматування (88% translated)" lang="uk" dir="ltr">українська</a></li> <li><a href="/Typographical_Guidelines/he" class="mw-pt-progress mw-pt-progress--low" title="הנחיות טיפוגרפיות (22% translated)" lang="he" dir="rtl">עברית</a></li> <li><a href="/Typographical_Guidelines/bn" class="mw-pt-progress mw-pt-progress--stub" title="টাইপোগ্রাফিক্যাল নির্দেশিকা (19% translated)" lang="bn" dir="ltr">বাংলা</a></li> <li><a href="/Typographical_Guidelines/zh-cn" class="mw-pt-progress mw-pt-progress--med" title="排版准则 (56% translated)" lang="zh-Hans-CN" dir="ltr">中文(中国大陆)</a></li> <li><a href="/Typographical_Guidelines/ja" class="mw-pt-progress mw-pt-progress--stub" title="Typographical Guidelines/ja (15% translated)" lang="ja" dir="ltr">日本語</a></li></ul></div> <p><i>There are separate pages explaining <a href="/Special:MyLanguage/Toolbox" title="Special:MyLanguage/Toolbox">syntax</a> with example code.</i> </p> <div class="alert mw-message-box-alert-error mw-message-box"> <figure class="mw-halign-left" typeof="mw:File"><span><img src="/images.userbase/thumb/0/02/Flag-red.png/40px-Flag-red.png" decoding="async" width="40" height="40" class="mw-file-element" srcset="/images.userbase/thumb/0/02/Flag-red.png/60px-Flag-red.png 1.5x, /images.userbase/thumb/0/02/Flag-red.png/80px-Flag-red.png 2x" /></span><figcaption></figcaption></figure> <div> <p><strong>Important</strong> </p> <div>Adhering to these typographic guidelines will ensure that your documentation can be accurately and easily exported for translation purposes. Some guidelines may not be applicable for non-English languages. These should be noted on specific language pages, linked from <a href="/Special:MyLanguage/Translation_Workflow" title="Special:MyLanguage/Translation Workflow">Translation Workflow</a>. If no such page exists for your language, please add one and make guidelines there.</div> </div> </div> <p><br /> </p> <meta property="mw:PageProp/toc" /> <h2><span class="mw-headline" id="Links">Links</span></h2> <p>Links to other UserBase pages should follow this pattern: </p> <pre style="background-color:lightyellow;">[[Special:MyLanguage/page name|whatever]]</pre> <p>[[Special:MyLanguage/Welcome to KDE UserBase|start page]] links to the welcome page in the readers language if the translation exists or else to the english version of that page. </p><p>Links to external pages follow normal wiki syntax: </p> <pre style="background-color:lightyellow;">[https://web.site.xxx/page text]</pre> <h2><span class="mw-headline" id="Bold_Text">Bold Text</span></h2> <p>Use bold text to highlight </p> <ul><li>Window titles</li> <li>Common labels that are not user-configurable</li> <li>Icon captions</li> <li>Program names</li></ul> <p>For example: </p> <ul><li>Highlighting a selection of text will copy it to <b>Klipper</b>.</li></ul> <h2><span class="mw-headline" id="Italic_Text">Italic Text</span></h2> <p>Use italic text to emphasise </p> <ul><li>Words or phrases as in general writing.</li> <li>Titles when referencing other works.</li> <li>The first use of an unfamiliar word.</li></ul> <p>Some examples: </p> <ul><li><i>Save your work at this point.</i></li> <li>Details can be found in <i>Samba 3 by Example</i>....</li> <li>KDE Manuals are in <i>Docbook</i> format.</li></ul> <div class="alert mw-message-box-alert-success mw-message-box"> <figure class="mw-halign-left" typeof="mw:File"><span><img src="/images.userbase/thumb/9/98/Ktip.png/40px-Ktip.png" decoding="async" width="40" height="40" class="mw-file-element" srcset="/images.userbase/thumb/9/98/Ktip.png/60px-Ktip.png 1.5x, /images.userbase/9/98/Ktip.png 2x" /></span><figcaption></figcaption></figure> <div> <p><strong>Tip</strong> </p> <div><i>Programs</i> are launched by users, <i>components</i> are used by programs</div> </div> </div> <p><br /> </p> <h2><span class="mw-headline" id="Combined_Bold_and_Italic_Text">Combined Bold and Italic Text</span></h2> <p>Use this combination for replaceable or variable text. </p><p>Some examples: </p> <ul><li>To connect to your remote server, type <code>ssh</code> <i><b><a href="/cdn-cgi/l/email-protection" class="__cf_email__" data-cfemail="b2c7c1d7c0dcd3dfd7f2d6dddfd3dbdc9cdcd3dfd7">[email&#160;protected]</a></b></i> in <b>Konsole</b>.</li> <li>In rpm-based distributions, the command <code>rpm -q</code> <i><b>packagename</b></i> will result in <i><b>package-version-release</b></i>.</li></ul> <h2><span class="mw-headline" id="Mono-spaced_Text">Mono-spaced Text</span></h2> <p>Code should be presented in mono-spaced text, usually boxed, as shown below. Input text will be on a light yellow background. For output text, the background colour will be a light grey. </p> <ul><li>Code, whether single lines or blocks, use templates to ensure consistency</li></ul> <ul><li>Use the Input template like this: <pre style="background-color:lightyellow;">{{Input|1=&lt;nowiki&gt; qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit rm -r ~/.kde/share/apps/nepomuk rm -r ~/.kde4/share/apps/nepomuk nepomukserver&lt;/nowiki&gt;}}</pre> This will display like this: <pre style="background-color:lightyellow;">qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit rm -r ~/.kde/share/apps/nepomuk rm -r ~/.kde4/share/apps/nepomuk nepomukserver</pre></li></ul> <p><br /> </p> <ul><li>Output works the same way: <pre class="ml-0">{{Output|1=&lt;nowiki&gt;terminal output is also shown as code, but on a grey background&lt;/nowiki&gt;}}</pre> which displays as <pre class="ml-0">terminal output is also shown as code, but on a grey background</pre></li></ul> <div class="alert mw-message-box-alert-success icon-dark-invert mw-message-box"> <figure class="mw-halign-left" typeof="mw:File"><span><img src="/images.userbase/thumb/c/c1/Note-box-icon.png/40px-Note-box-icon.png" decoding="async" width="40" height="40" class="mw-file-element" srcset="/images.userbase/thumb/c/c1/Note-box-icon.png/60px-Note-box-icon.png 1.5x, /images.userbase/thumb/c/c1/Note-box-icon.png/80px-Note-box-icon.png 2x" /></span><figcaption></figcaption></figure> <div> <p><strong>Note</strong> </p> <div>Note the use of <code>1=&lt;nowiki&gt; some text &lt;/nowiki&gt;</code>. Occationally, parts of literal displays may confuse the wiki parser. The <code>&lt;nowiki&gt;...&lt;/nowiki&gt;</code> block protects against that. Also if something like <tt>n=</tt> appears in the literal body, the template parser may get confused. The initial <code>1=</code> protects against that. Otherwise this markup has no effect. In short: it can't hurt, and it protects against the possibility of some nasty side effects.</div> </div> </div> <p><br /> </p> <ul><li>Starting an Input or Output template on a new line will break the display format if it is within lists. Simply continue on the same line if you need to correct this.</li></ul> <ul><li>You can also combine input/output areas with <a class="external text" href="http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi">GeSHi syntaxhiglighting</a>. An input area like this <pre style="background-color:lightyellow;">{{Input|&lt;syntaxhighlight lang="php" line&gt; # Initialise common code $preIP = dirname( __FILE__ ); require_once( "$preIP/includes/WebStart.php" ); &lt;/syntaxhighlight&gt;}}</pre> will result in <pre style="background-color:lightyellow;"><div class="mw-highlight mw-highlight-lang-php mw-content-ltr mw-highlight-lines" dir="ltr"><pre><span></span><span class="linenos" data-line="1"></span><span class="c1"># Initialise common code</span> <span class="linenos" data-line="2"></span><span class="nv">$preIP</span> <span class="o">=</span> <span class="nb">dirname</span><span class="p">(</span> <span class="no">__FILE__</span> <span class="p">);</span> <span class="linenos" data-line="3"></span><span class="k">require_once</span><span class="p">(</span> <span class="s2">&quot;</span><span class="si">$preIP</span><span class="s2">/includes/WebStart.php&quot;</span> <span class="p">);</span> </pre></div></pre></li></ul> <ul><li>Single code words can be kept in-line by using <pre style="background-color:lightyellow;">&lt;code&gt;&lt;/code&gt;</pre> It will <code>display</code> like this. Note, that if the &lt;code&gt; tag is immediately preceded by a newline character, it will not display properly.</li></ul> <ul><li>File names and paths should use the Path template (see below).</li></ul> <div class="alert mw-message-box-alert-warning mw-message-box"> <figure class="mw-halign-left" typeof="mw:File"><span><img src="/images.userbase/thumb/c/cb/Warning.png/40px-Warning.png" decoding="async" width="40" height="40" class="mw-file-element" srcset="/images.userbase/thumb/c/cb/Warning.png/60px-Warning.png 1.5x, /images.userbase/thumb/c/cb/Warning.png/80px-Warning.png 2x" /></span><figcaption></figcaption></figure> <div> <p><strong>Warning</strong> </p> <div>In-line code markup should be short! It looks strange - and ugly - if a string of code words is split between lines. And remember: even if it looks good in your browser, not everyone uses the same screen size! And even if your text looks good on all screen sizes translations may still suffer. It is best to use the Input template for code unless it is really short.</div> </div> </div> <p><br /> </p> <div class="alert mw-message-box-alert-success icon-dark-invert mw-message-box"> <figure class="mw-halign-left" typeof="mw:File"><span><img src="/images.userbase/thumb/c/c1/Note-box-icon.png/40px-Note-box-icon.png" decoding="async" width="40" height="40" class="mw-file-element" srcset="/images.userbase/thumb/c/c1/Note-box-icon.png/60px-Note-box-icon.png 1.5x, /images.userbase/thumb/c/c1/Note-box-icon.png/80px-Note-box-icon.png 2x" /></span><figcaption></figcaption></figure> <div> <p><strong>Note</strong> </p> <div>Please avoid using shell commands or other code words as verbs. This does not translate well. Always treat code words as proper names.</div> </div> </div> <p><br /> </p> <h2><span class="mw-headline" id="Block_Quotes">Block Quotes</span></h2> <p>The tags &lt;blockquote&gt; and &lt;/blockquote&gt; should be used when quoting other works or other pages. This produces a proportional italic font, with some padding. </p> <blockquote><p>Here is an example of the display that you get by using the blockquote tags.</p></blockquote> <h2><span class="mw-headline" id="Text_in_Section_Headers">Text in Section Headers</span></h2> <p>Even though the criteria above may be met, do not use Bold text in section headers or in links. </p> <h2><span id="Text_in_Information.2C_Note.2C_Tip_or_Warning_Templates"></span><span class="mw-headline" id="Text_in_Information,_Note,_Tip_or_Warning_Templates">Text in Information, Note, Tip or Warning Templates</span></h2> <p>Bold text should be avoided in the text within these templates. Italic text for emphasis may still be used - use sparingly for maximum effect. <span id="Lists"></span> </p> <h2><span class="mw-headline" id="Lists">Lists</span></h2> <p>You can have various kinds of lists in your pages &#8212; bulleted, numbered or itemized. Find details on the <a href="/Special:MyLanguage/Toolbox#Bulleted_Lists" title="Special:MyLanguage/Toolbox">Toolbox</a> page. <span id="Keeping_things_together"></span> </p> <h2><span class="mw-headline" id="Keeping_things_together">Keeping things together</span></h2> <p>After your text is written some markup is automatically added by the translation system. This means that whenever it sees a blank line, it starts a new unit. When your text is presented to translators, they typically see it one unit at a time, so it is important not to leave a blank lines in the middle of something that should be treated as a unit. Normally an entire paragraph should be kept in a single unit; and under no circumstance should a sentence be split between units! </p><p>If you need a linebreak in the middle of a section, the preferred way to achieve this without breaking units is to use &lt;br /&gt; at the end of the line where you want to break to occur (not on a new line). If you need space between the lines add &lt;br /&gt;&lt;br /&gt;. <span id="Unbalanced_brackets"></span> </p> <h2><span class="mw-headline" id="Unbalanced_brackets">Unbalanced brackets</span></h2> <p>The translation system marks any translated unit as incompletely translated if it contains any kind of unbalanced brackets. If you need to have unbalanced brackets in your text, please add a balancing bracket in a comment tag, like this:<br /> </p> <pre style="background-color:lightyellow;">&lt;!-- }} --&gt;{{ A line Another line}}&lt;!-- {{ --&gt;</pre> <p>This goes for all kinds of brackets, even ordinary parentheses. (Of course it is normally better to avoid blank lines within a mark up unit - see <a href="/Special:MyLanguage/Typographical_Guidelines#Keeping_things_together" title="Special:MyLanguage/Typographical Guidelines">Keeping things together</a>.) </p> <h2><span class="mw-headline" id="Special_Tags">Special Tags</span></h2> <h3><span class="mw-headline" id="Key_presses_and_menu_selections">Key presses and menu selections</span></h3> <ul><li> &lt;keycap&gt; and &lt;/keycap&gt; denote (keyboard) key names e.g. <span class="keycap">Enter</span></li> <li>&lt;keycap&gt;&lt;/keycap&gt; can also be used around groups of keys to be used concurrently, e.g. <span class="keycap">Ctrl + Alt + F1</span> to launch a virtual terminal. (Note that "(space)+(space)" is used to link keys to be pressed concurrently).</li> <li>Sequences of menu choices should use &lt;menuchoice&gt; and &lt;/menuchoice&gt; for example <span class="menuchoice"> View -&gt; Message List -&gt; Aggregation -&gt; Standard Mailing List </span></li> <li>In general, if the user needs to choose an element, even if it is not in a menu, the &lt;menuchoice&gt;&lt;/menuchoiсe&gt; markup should be used.</li> <li>If you are contributing to a manual page, you should always use the markup describes above. For other pages, though, there is a template to enter menu selections: {{Menu|Top|sub|...}}. Fx, {{Menu | View | Message List | Aggregation | Standard Mailing List}} yields <span class="menuchoice"> View </span> &#8594; <span class="menuchoice"> Message List </span> &#8594; <span class="menuchoice"> Aggregation </span> &#8594; <span class="menuchoice"> Standard Mailing List</span></li> <li>If you want to use the &lt;menuchoice&gt; but use &#8594; in stead of -&gt;, you write <code>&amp; rarr;</code> (without a space between '&amp;' and r!) as in &lt;menuchoice&gt; View&lt;/menuchoice&gt; &amp; rarr; &lt;menuchoice&gt;Message List&lt;/menuchoice&gt; which yields <span class="menuchoice"> View</span> &#8594; <span class="menuchoice">Message List</span>. (Note, that the &#8594; character has to be outside of the menuchoice tags to be shown properly</li></ul> <h3><span class="mw-headline" id="Files_and_file_paths">Files and file paths</span></h3> <p>Traditionally, file names and paths have been marked up between &lt;tt&gt;...&lt;/tt&gt; tags. </p> <pre style="background-color:lightyellow;">&lt;tt&gt;~/.kde/share&lt;/tt&gt;</pre> <p>yields </p> <pre class="ml-0"><tt>~/.kde/share</tt></pre> <p>There is now also a template for this, which should be preferred in new content for ordinary UserBase pages (but not for manual pages, please!): </p> <pre style="background-color:lightyellow;">{{Path | ~/.kde/share }}</pre> <p>yields </p> <pre class="ml-0"><kbd> ~/.kde/share </kbd></pre> <h2><span class="mw-headline" id="The_Problematic_Pipe">The Problematic Pipe</span></h2><p> In some situations the pipe symbol can't be used - for instance when adding parameters into a template. In any such case, please use {{!}} which will display as a pipe symbol. For example, if you want to display a command line containing the pipe character using the {{Input|...}} template, the simplest way to do it is this: <code>{{Input|1=cmd1 {{!}} cmd2}}</code> which displays </p><pre style="background-color:lightyellow;">cmd1 | cmd2</pre> <p><br />If you just write <code>{{Input|cmd1 | cmd2}}</code> you get instead </p><pre style="background-color:lightyellow;">cmd1 </pre> <p>the problem being, that <code>cmd2</code> is seen as a second parameter to the template, which in this case is not used. </p><p> In many cases, you can also enclose the text containing the pipe character between &lt;nowiki&gt;... &lt;/nowiki&gt; tags, like this <code>{{Input|1=&lt;nowiki&gt;cmd1 | cmd2&lt;/nowiki&gt;}}</code>, which also displays </p><pre style="background-color:lightyellow;">cmd1 | cmd2</pre> <h2><span class="mw-headline" id="Translatable_Content">Translatable Content</span></h2> <p>Everything that is translatable is contained within &lt;translate&gt; and &lt;/translate&gt; tags. In most cases any images should be contained within the translatable section, as it is sometimes necessary to use localised versions of the images to explain a point. The rule of thumb is "If in doubt, include it!". </p> <!-- NewPP limit report Cached time: 20241124104704 Cache expiry: 86400 Reduced expiry: false Complications: [show‐toc] CPU time usage: 0.053 seconds Real time usage: 0.175 seconds Preprocessor visited node count: 663/1000000 Post‐expand include size: 6909/2097152 bytes Template argument size: 4246/2097152 bytes Highest expansion depth: 7/100 Expensive parser function count: 1/100 Unstrip recursion depth: 0/20 Unstrip post‐expand size: 5158/5000000 bytes --> <!-- Transclusion expansion time report (%,ms,calls,template) 100.00% 131.968 1 -total 95.29% 125.759 13 Template:Input 0.91% 1.196 1 Template:Remember 0.80% 1.062 5 Template:Box 0.69% 0.904 1 Template:Menu 0.65% 0.853 4 Template:Output 0.57% 0.755 2 Template:Note 0.54% 0.717 1 Template:Warning 0.39% 0.518 1 Template:Tip 0.28% 0.376 1 Template:Path --> <!-- Saved in parser cache with key userbase:pcache:idhash:7898-0!canonical and timestamp 20241124104704 and revision id 494128. Rendering was triggered because: page-view --> </div> <div class="printfooter" data-nosnippet="">Retrieved from "<a dir="ltr" href="https://userbase.kde.org/index.php?title=Typographical_Guidelines&amp;oldid=494128">https://userbase.kde.org/index.php?title=Typographical_Guidelines&amp;oldid=494128</a>"</div></div> <div id="catlinks" class="catlinks" data-mw="interface"><div id="mw-normal-catlinks" class="mw-normal-catlinks"><a href="/Special:Categories" title="Special:Categories">Category</a>: <ul><li><a href="/Category:Contributing" title="Category:Contributing">Contributing</a></li></ul></div></div> </div> </main> </div> <div class="mw-footer-container"> <footer id="footer" class="mw-footer" role="contentinfo" > <ul id="footer-info"> <li id="footer-info-lastmod"> This page was last edited on 23 April 2024, at 11:05.</li> <li id="footer-info-copyright">Content is available under <a class="external" rel="nofollow" href="/KDE_UserBase_Wiki:Copyrights">Creative Commons License SA 4.0</a> unless otherwise noted.</li> </ul> <ul id="footer-places"> <li id="footer-places-privacy"><a href="/KDE_UserBase_Wiki:Privacy_policy">Privacy policy</a></li> <li id="footer-places-about"><a href="/KDE_UserBase_Wiki:About">About KDE UserBase Wiki</a></li> <li id="footer-places-disclaimers"><a href="/KDE_UserBase_Wiki:General_disclaimer">Disclaimers</a></li> </ul> <ul id="footer-icons" class="noprint"> <li id="footer-copyrightico"><a href="/KDE_UserBase_Wiki:Copyrights"><img src="/resources/assets/licenses/gfdlcc.png" alt="Creative Commons License SA 4.0" width="88" height="31" loading="lazy"></a></li> <li id="footer-poweredbyico"><a href="https://www.mediawiki.org/"><img src="/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31" loading="lazy"></a></li> </ul> </footer> </div> </div> </div> <div class="vector-settings" id="p-dock-bottom"> <ul> <li> <button class="cdx-button cdx-button--icon-only vector-limited-width-toggle" id=""><span class="vector-icon mw-ui-icon-fullScreen mw-ui-icon-wikimedia-fullScreen"></span> <span>Toggle limited content width</span> </button> </li> </ul> </div> <script data-cfasync="false" src="/cdn-cgi/scripts/5c5dd728/cloudflare-static/email-decode.min.js"></script><script>(RLQ=window.RLQ||[]).push(function(){mw.config.set({"wgBackendResponseTime":255,"wgPageParseReport":{"limitreport":{"cputime":"0.053","walltime":"0.175","ppvisitednodes":{"value":663,"limit":1000000},"postexpandincludesize":{"value":6909,"limit":2097152},"templateargumentsize":{"value":4246,"limit":2097152},"expansiondepth":{"value":7,"limit":100},"expensivefunctioncount":{"value":1,"limit":100},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":5158,"limit":5000000},"timingprofile":["100.00% 131.968 1 -total"," 95.29% 125.759 13 Template:Input"," 0.91% 1.196 1 Template:Remember"," 0.80% 1.062 5 Template:Box"," 0.69% 0.904 1 Template:Menu"," 0.65% 0.853 4 Template:Output"," 0.57% 0.755 2 Template:Note"," 0.54% 0.717 1 Template:Warning"," 0.39% 0.518 1 Template:Tip"," 0.28% 0.376 1 Template:Path"]},"cachereport":{"timestamp":"20241124104704","ttl":86400,"transientcontent":false}}});});</script> <!-- Matomo --> <script type="text/javascript"> var _paq = _paq || []; _paq.push(["trackPageView"]); _paq.push(["enableLinkTracking"]); (function() { var u = (("https:" == document.location.protocol) ? "https" : "http") + "://"+"stats.kde.org/"; _paq.push(["setTrackerUrl", u+"piwik.php"]); _paq.push(["setSiteId", "23"]); var d=document, g=d.createElement("script"), s=d.getElementsByTagName("script")[0]; g.type="text/javascript"; g.defer=true; g.async=true; g.src=u+"piwik.js"; s.parentNode.insertBefore(g,s); })(); </script> <!-- End Matomo Code --> <!-- Matomo Image Tracker --> <noscript><img src="https://stats.kde.org/piwik.php?idsite=23&rec=1" style="border:0" alt="" /></noscript> <!-- End Matomo --> </body> </html>

Pages: 1 2 3 4 5 6 7 8 9 10