Wikisumber:Bak pasir: Perbedaan antara revisi

Konten dihapus Konten ditambahkan
Empat Tilda (bicara | kontrib)
←Mengganti halaman dengan ' {{help-stub}}'
Tag: Penggantian
Empat Tilda (bicara | kontrib)
Tidak ada ringkasan suntingan
Baris 1:
{{process header
| title = Konvensi Bentuk
| section =
| previous = [[Bantuan:Status_Halaman|Status Halaman]]
| next = [[Bantuan:Transklusi|Transklusi]]
| shortcut =
| notes = Konvensi pemformatan standar yang digunakan untuk Uji-Baca di Wikisource.
}}
 
__TOC__
 
{{help-stubDhr|2.0em}}
 
The following conventions are considered best practices for pages in the Page: namespace (DjVu files, PDFs and other files which use the ProofreadPage extension). For general article formatting conventions and guidelines see [[Wikisource:Style guide]].
 
== Running headers ==
 
A scanned page's header and footer often include page number and titles, which are not [[H:transclusion|transcluded]]. Place this information in the [[Help:Page scans|header and footer]] edit boxes, accessed by clicking the [[File:Header and footer toolbar button.svg|link=|22px]] which appears above the edit window, in the {{code|Proofread tools}} section.
 
The {{tl|RunningHeader}} template is useful for formatting these headers, and is used as follows:
* <code><nowiki>{{RunningHeader|left=|center=|right=}}</nowiki></Code>
* Text in the left, center, or right parameters will appear on the same line.
* Five-entry style headers, such as those that appear in certain encyclopedias and dictionaries can be entered with {{tl|rh/5}}
 
{{anchor|LINEBREAKS}}
 
== Line breaks ==
{{shortcut|[[H:LINEBREAKS]]}}
* Remove end-of-line hyphens and line breaks.
 
{|
| style="vertical-align:top;" |
<pre style="color:red; white-space:pre;">
It was a dark and stormy night, the rain fell in tor-⏎
rents—except at occasional intervals, when it was⏎
checked by a violent gust of wind which⏎
...
</pre>
| style="vertical-align:top;" |
<pre style="white-space:normal; color:green;">
It was a dark and stormy night, the rain fell in torrents—except at occasional intervals, when it was checked by a violent gust of wind which...
</pre>
|}
 
* To start a new paragraph, MediaWiki pages use two line breaks (i.e., press return twice and leave one line blank):
<pre style="color:green;">
...this is the end of one paragraph.
 
This is the start of the next paragraph...
</pre>
 
* Poetry and other texts presented on a line-by-line basis should have their line breaks preserved. See [[H:POEM]] for how to format them.
 
== Hyphenated end of page words ==
{{anchor|hyphenation}}<!-- Used for the below shortcut -->
{{Shortcut|H:HYPHEN}}
* When a word is hyphenated onto two consecutive pages of the scans, the software will automatically remove the hyphen and join the words together when [[H:Transclusion|transcluded]] into the main namespace.
*: First page: <code>Sometimes words are hyphen-</code>
*: Second page: <code>ated across page breaks.</code>
*: Final result: "Sometimes words are hyphenated across page breaks."
** Note: Some older works use the templates {{tl|hws}} and {{tl|hwe}}: these are no longer required for newly created pages.
* If you wish to ''keep'' the hyphen (''e.g.,'' in the word "over-eager"), use {{tl|peh}} (a.k.a. {{tl|page end hyphen}}) and the software will not remove it:
*: First page: <code>Sometimes removal of hyphens is over{{tl|peh}}</code>
*: Second page <code>eager: you wish to keep the hyphen.</code>
*: Final result: "Sometimes removal of hyphens is over-eager: you wish to keep the hyphen."
* If a link goes across a page break, use {{tl|lps}} and {{tl|lpe}}. See the documentation of those templates for the various cases that they support.
 
== Paragraph ending at the bottom of a page ==
 
* If a paragraph ends at the bottom of a page scan and a new paragraph in the same chapter will start on the next page, add {{tl|nop}} at the bottom of the page (on its own line) to force a break in the text. Otherwise, when the pages are transcluded the separation between the two pages will be treated as a single space rather than a new line. Example: ([[Page:Personal Recollections of Joan of Arc.djvu/476]] and [[Personal Recollections of Joan of Arc/Book III/Chapter 14]]).
 
== Templates ==
{{see also|Help:Templates}}
* Using [[Help:Templates|standard templates]] instead of other types of markup, gives Wikisource protection from undesirable external changes. e.g., Use {{tl|right}} instead of <code><nowiki><p align="right"></nowiki></code>.
** If you need to indicate a word/phrase should be in {{small-caps|Small Caps}}, use the {{tl|small-caps}} template.
** If you need to indicate a word/phrase should be in a smaller (or larger) font, use the {{tl|smaller}} template. Similarly, the {{tl|xx-smaller}}, {{tl|x-smaller}}, {{tl|larger}}, {{tl|x-larger}}, {{tl|xx-larger}}, and {{tl|font-size}} templates can be used to modify text size.
 
== Footnotes ==
* [[Help:Footnotes and endnotes|Footnotes]] in the print version of the book should be implemented using the <code><nowiki><ref></ref></nowiki></code> and <code><nowiki><references/></nowiki></code> ( or {{tl|smallrefs}} ) mark up. The {{tl|reflist}} mark-up is for Author and Main namespaces.
 
{{anchor|OLDMARKUP}}
== Obsolete markup ==
{{shortcut|[[H:OLDMARKUP]]}}
Some markup is obsolete in modern HTML and will eventually be removed from browsers and MediaWiki. This is not a MediaWiki or Wikisource decision: the HTML constructs are deprecated by the official web standards body, the W3C.
 
Generally, there are two kinds of deprecation:
* Obsolete tags (tags look like <code><nowiki><this></nowiki></code>) that represent "non-semantic" content and are more correctly done using semantically-meaningful tags and styles via CSS
* Obsolete ''attributes'' on tags (attributes look like <code><nowiki><tag attribute=this orthis></nowiki></code>) which encode stylistic information that is more correctly implemented in CSS
 
In some cases, for example, in EPUB exports, such deprecated HTML can cause client problems and the exporter will attempt to strip the problematic code and replace with a best-effort replacement. This does not always work.
 
Some deprecations that are common, and their resolutions
 
* Obsolete HTML tags. Use of these tags triggers [[Special:LintErrors/obsolete-tag|linter errors]].
** <code><nowiki><center></nowiki></code>: use {{tl|center}}
** <code><nowiki><big></nowiki></code>: use {{tl|larger}}
** <code><nowiki><small></nowiki></code>: use {{tl|smaller}}
** <code><nowiki><font></nowiki></code>: use templates like {{tl|blackletter}}, {{tl|red}}, etc., as appropriate
** <code><nowiki><tt></nowiki></code>: use {{tl|monospace}}
 
*The use of the <code>align</code> attribute is also deprecated and should be replaced with CSS:
** For table positioning<ref>https://developer.mozilla.org/en-US/docs/Web/HTML/Element/table#attr-align</ref>
*** <code>align=center</code>: use <code>style="margin: auto;"</code>
*** <code>align=left/right</code>: use <code>style="margin-right/margin-left: auto;"</code> (the margin is on the "blank" side of the table)
*** <code>align=left/right</code>: use <code>style="float: left/right;"</code> (this allows surrounding content to "flow" around the table)
** For text alignment (e.g., in table ''cells'')<ref>https://developer.mozilla.org/en-US/docs/Web/HTML/Element/td#attr-align</ref>:
*** <code>align=left/center/right</code>: use <code>style="text-align: left/center/right;"</code>
*The use of the <code>valign</code> attribute should be replaced with CSS<ref>[https://developer.mozilla.org/en-US/docs/Web/HTML/Element/table#attr-valign in tables], [https://developer.mozilla.org/en-US/docs/Web/HTML/Element/td#attr-align in table cells]</ref>:
** <code>valign=top</code> → <code>vertical-align: top;</code>
** <code>valign=middle</code> → <code>vertical-align: middle;</code>
** <code>valign=bottom</code> → <code>vertical-align: bottom;</code>
* ''All'' other table-specific attributes on tables are deprecated <ref>https://developer.mozilla.org/en-US/docs/Web/HTML/Element/table#attributes</ref>:
** <code>width</code>: use CSS <code>width</code>
** <code>frame</code>: use CSS <code>border</code>
** <code>cellpadding</code>: use CSS <code>padding</code> on the cells, and set <code>border-collapse: collapse</code>
** <code>cellspacing</code>: use CSS <code>border-spacing</code> and do not <code>border-collapse</code> (both apply to the table, not the cells)
** <code>bgcolor</code>: use CSS <code>background-color</code>
 
=== Tagging ===
 
Some, but not all, deprecations are automatically tagged by an [[Special:AbuseFilter/41|edit filter]]. If your edits are so tagged, you may wish to adjust the content to avoid a deprecated construction. You do not have to do so, but it will avoid creating a backlog if/when such deprecations cause technical issues in the future. Recent changes with this tag can be seen [https://en.wikisource.org/w/index.php?title=Special:RecentChanges&tagfilter=deprecated+markup here]. Sometimes, your edits may be tagged not because of your contributions, but because of pre-existing deprecated markup.
 
== Notes ==
<references/>
{{dhr|3}}
{{Proofreading help navbox}}
 
[[Category:Help]]