Craftpedia Article Style Guide: Difference between revisions
CraftAdmin (talk | contribs) No edit summary |
CraftAdmin (talk | contribs) Marked this version for translation |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
<languages /> | <languages /> | ||
<translate> | <translate> | ||
<!--T:50--> | |||
This document defines the standard structure, tone, and formatting rules for all Craftpedia articles about traditional crafts and artisanal techniques. | This document defines the standard structure, tone, and formatting rules for all Craftpedia articles about traditional crafts and artisanal techniques. | ||
It applies to every language and every regional portal. | It applies to every language and every regional portal. | ||
<!--T:51--> | |||
The purpose of this guide is to ensure that all Craftpedia articles are consistent, academically reliable, and easy to read, while remaining compatible with machine-assisted translation workflows. | The purpose of this guide is to ensure that all Craftpedia articles are consistent, academically reliable, and easy to read, while remaining compatible with machine-assisted translation workflows. | ||
<!--T:52--> | |||
__TOC__ | __TOC__ | ||
<!--T:53--> | |||
== Purpose of This Guide == | == Purpose of This Guide == | ||
The Craftpedia Article Style Guide establishes: | The Craftpedia Article Style Guide establishes: | ||
| Line 17: | Line 21: | ||
* cross-language consistency rules. | * cross-language consistency rules. | ||
<!--T:54--> | |||
Every article in Craftpedia must follow this structure unless a portal adopts a more detailed local standard. | Every article in Craftpedia must follow this structure unless a portal adopts a more detailed local standard. | ||
<!--T:55--> | |||
== General Principles == | == General Principles == | ||
Craftpedia articles must follow these principles: | Craftpedia articles must follow these principles: | ||
'''Clarity''' – Information must be presented in a clear and readable way. | <!--T:56--> | ||
'''Accuracy''' – Every statement must be fact-checked using authoritative sources. | * '''Clarity''' – Information must be presented in a clear and readable way. | ||
'''Neutrality''' – Articles must avoid promotional or biased language. | * '''Accuracy''' – Every statement must be fact-checked using authoritative sources. | ||
'''Consistency''' – All portals must follow the same article structure. | * '''Neutrality''' – Articles must avoid promotional or biased language. | ||
'''Respect for Cultural Heritage''' – Terminology and descriptions must treat all cultural traditions with care. | * '''Consistency''' – All portals must follow the same article structure. | ||
* '''Respect for Cultural Heritage''' – Terminology and descriptions must treat all cultural traditions with care. | |||
<!--T:95--> | |||
== Article Structure Template == | == Article Structure Template == | ||
Each Craftpedia article about a craft tradition should follow the standard structure. | Each Craftpedia article about a craft tradition should follow the standard structure. | ||
Sections may be expanded, but not removed. | Sections may be expanded, but not removed. | ||
<!--T:58--> | |||
=== Lead / Introduction === | === Lead / Introduction === | ||
A short summary (2–4 sentences) that includes: | A short summary (2–4 sentences) that includes: | ||
| Line 39: | Line 48: | ||
* its cultural significance. | * its cultural significance. | ||
<!--T:59--> | |||
The introduction must not contain detailed history or long lists. | The introduction must not contain detailed history or long lists. | ||
<!--T:60--> | |||
Example: | Example: | ||
<blockquote> | <blockquote> | ||
| Line 46: | Line 57: | ||
</blockquote> | </blockquote> | ||
<!--T:61--> | |||
=== Historical Background === | === Historical Background === | ||
Covers: | Covers: | ||
| Line 53: | Line 65: | ||
* periods of innovation or decline. | * periods of innovation or decline. | ||
<!--T:62--> | |||
This section may refer to historical periods (e.g., Edo period, Qing dynasty, Joseon era). | This section may refer to historical periods (e.g., Edo period, Qing dynasty, Joseon era). | ||
<!--T:63--> | |||
=== Materials === | === Materials === | ||
Describes: | Describes: | ||
| Line 61: | Line 75: | ||
* preparation methods (refining, filtering, alloying, softening). | * preparation methods (refining, filtering, alloying, softening). | ||
<!--T:64--> | |||
If relevant, describe regional variations. | If relevant, describe regional variations. | ||
<!--T:65--> | |||
=== Techniques === | === Techniques === | ||
Explains: | Explains: | ||
| Line 69: | Line 85: | ||
* unique or characteristic methods. | * unique or characteristic methods. | ||
<!--T:66--> | |||
This section should be factual, not instructional. | This section should be factual, not instructional. | ||
<!--T:67--> | |||
=== Tools and Equipment === | === Tools and Equipment === | ||
(Required only if relevant) | (Required only if relevant) | ||
<!--T:68--> | |||
Includes: | Includes: | ||
* traditional tools (e.g., bamboo brushes, kick wheels, chisels); | * traditional tools (e.g., bamboo brushes, kick wheels, chisels); | ||
* specialized equipment (kilns, looms, furnaces). | * specialized equipment (kilns, looms, furnaces). | ||
<!--T:69--> | |||
=== Regional Variations === | === Regional Variations === | ||
Describes differences across: | Describes differences across: | ||
| Line 84: | Line 104: | ||
* regional schools or styles. | * regional schools or styles. | ||
<!--T:70--> | |||
Each variation should be clearly marked with a subheading. | Each variation should be clearly marked with a subheading. | ||
<!--T:71--> | |||
=== Cultural and Ritual Significance === | === Cultural and Ritual Significance === | ||
(Required only if applicable) | (Required only if applicable) | ||
<!--T:72--> | |||
Explains: | Explains: | ||
* symbolic meaning; | * symbolic meaning; | ||
| Line 95: | Line 118: | ||
* relevance in traditional events or beliefs. | * relevance in traditional events or beliefs. | ||
<!--T:73--> | |||
=== Modern Developments === | === Modern Developments === | ||
Covers: | Covers: | ||
| Line 103: | Line 127: | ||
* integration into modern design or industry. | * integration into modern design or industry. | ||
<!--T:74--> | |||
=== Notable Objects or Types === | === Notable Objects or Types === | ||
A curated list of representative object forms connected to the craft. | A curated list of representative object forms connected to the craft. | ||
<!--T:75--> | |||
Examples: | Examples: | ||
* flower vases | * flower vases | ||
| Line 112: | Line 138: | ||
* sword fittings | * sword fittings | ||
<!--T:76--> | |||
Each item may link to its own article if available. | Each item may link to its own article if available. | ||
<!--T:77--> | |||
=== Gallery === | === Gallery === | ||
Images must follow: | Images must follow: | ||
| Line 121: | Line 149: | ||
* accurate and neutral captions. | * accurate and neutral captions. | ||
<!--T:78--> | |||
=== References === | === References === | ||
Every article must include: | Every article must include: | ||
| Line 129: | Line 158: | ||
* peer-reviewed sources. | * peer-reviewed sources. | ||
<!--T:79--> | |||
Websites may be included if reputable (museums, universities, cultural institutions). | Websites may be included if reputable (museums, universities, cultural institutions). | ||
<!--T:80--> | |||
=== Category Section === | === Category Section === | ||
Articles must include: | Articles must include: | ||
<!--T:81--> | |||
; Mandatory categories: | ; Mandatory categories: | ||
* a domain category such as <nowiki>[[Category:Ceramics]]</nowiki>, <nowiki>[[Category:Metalwork]]</nowiki>, etc. | * a domain category such as <nowiki>[[Category:Ceramics]]</nowiki>, <nowiki>[[Category:Metalwork]]</nowiki>, etc. | ||
| Line 139: | Line 171: | ||
* a historical period category when clearly applicable | * a historical period category when clearly applicable | ||
<!--T:82--> | |||
; Optional categories (when applicable): | ; Optional categories (when applicable): | ||
* period categories (e.g. <nowiki>[[Category:Edo period]]</nowiki>) | * period categories (e.g. <nowiki>[[Category:Edo period]]</nowiki>) | ||
| Line 146: | Line 179: | ||
* technique or subfamily categories (e.g. <nowiki>[[Category:Porcelain]]</nowiki>, <nowiki>[[Category:Stoneware]]</nowiki>, <nowiki>[[Category:Bronze casting]]</nowiki>) | * technique or subfamily categories (e.g. <nowiki>[[Category:Porcelain]]</nowiki>, <nowiki>[[Category:Stoneware]]</nowiki>, <nowiki>[[Category:Bronze casting]]</nowiki>) | ||
<!--T:83--> | |||
Categories must follow the naming conventions defined in the Category System Specification. | Categories must follow the naming conventions defined in the Category System Specification. | ||
<!--T:84--> | |||
== Writing Tone and Style == | == Writing Tone and Style == | ||
* Use a neutral, academic tone similar to museum catalog descriptions. | * Use a neutral, academic tone similar to museum catalog descriptions. | ||
| Line 155: | Line 190: | ||
* Introduce Japanese, Chinese, or other local terms with transliteration on first use. | * Introduce Japanese, Chinese, or other local terms with transliteration on first use. | ||
<!--T:85--> | |||
Example: | Example: | ||
; Correct: | ; Correct: | ||
| Line 161: | Line 197: | ||
“This amazing technique beautifully uses clay from the area.” | “This amazing technique beautifully uses clay from the area.” | ||
== Terminology Rules == | == Terminology Rules == <!--T:86--> | ||
<!--T:87--> | |||
=== Craft Names === | === Craft Names === | ||
* English name first | * English name first | ||
* Local name second (script + transliteration) | * Local name second (script + transliteration) | ||
<!--T:88--> | |||
Example: | Example: | ||
'''Imari ware''' (伊万里焼, ''Imari-yaki'') | '''Imari ware''' (伊万里焼, ''Imari-yaki'') | ||
<!--T:89--> | |||
=== Transliteration === | === Transliteration === | ||
Follow ISO or widely accepted museum standards: | Follow ISO or widely accepted museum standards: | ||
| Line 176: | Line 215: | ||
* Korean: Revised Romanization | * Korean: Revised Romanization | ||
<!--T:90--> | |||
=== Historical Periods === | === Historical Periods === | ||
Always use standardized English period names: | Always use standardized English period names: | ||
| Line 183: | Line 223: | ||
* Joseon dynasty | * Joseon dynasty | ||
<!--T:91--> | |||
== Image Use and Caption Style == | == Image Use and Caption Style == | ||
Captions must: | Captions must: | ||
| Line 190: | Line 231: | ||
* credit museums or sources when needed. | * credit museums or sources when needed. | ||
<!--T:92--> | |||
Example: | Example: | ||
“Porcelain bowl with underglaze blue decoration, Edo period (18th century). Arita ware. Image: Wikimedia Commons / CC BY-SA 4.0.” | “Porcelain bowl with underglaze blue decoration, Edo period (18th century). Arita ware. Image: Wikimedia Commons / CC BY-SA 4.0.” | ||
<!--T:93--> | |||
== Common Errors to Avoid == | == Common Errors to Avoid == | ||
* mixing historical facts with modern interpretations; | * mixing historical facts with modern interpretations; | ||
| Line 202: | Line 245: | ||
* describing personal opinions. | * describing personal opinions. | ||
<!--T:94--> | |||
== Version History == | == Version History == | ||
* 1.1 – Replaced “craft article” with “Craftpedia article” and “article about a craft tradition” | * 1.1 – Replaced “craft article” with “Craftpedia article” and “article about a craft tradition” | ||
* 1.0 – Initial release (English) | * 1.0 – Initial release (English) | ||
</translate> | </translate> | ||
Latest revision as of 07:20, 29 November 2025
This document defines the standard structure, tone, and formatting rules for all Craftpedia articles about traditional crafts and artisanal techniques. It applies to every language and every regional portal.
The purpose of this guide is to ensure that all Craftpedia articles are consistent, academically reliable, and easy to read, while remaining compatible with machine-assisted translation workflows.
Purpose of This Guide
[edit]The Craftpedia Article Style Guide establishes:
- the required structure for articles;
- the preferred writing tone;
- formatting conventions;
- category rules;
- image usage guidelines;
- cross-language consistency rules.
Every article in Craftpedia must follow this structure unless a portal adopts a more detailed local standard.
General Principles
[edit]Craftpedia articles must follow these principles:
- Clarity – Information must be presented in a clear and readable way.
- Accuracy – Every statement must be fact-checked using authoritative sources.
- Neutrality – Articles must avoid promotional or biased language.
- Consistency – All portals must follow the same article structure.
- Respect for Cultural Heritage – Terminology and descriptions must treat all cultural traditions with care.
Article Structure Template
[edit]Each Craftpedia article about a craft tradition should follow the standard structure. Sections may be expanded, but not removed.
Lead / Introduction
[edit]A short summary (2–4 sentences) that includes:
- the name of the craft (English name + original language form if relevant);
- the craft’s origin or region;
- the main materials and techniques;
- its cultural significance.
The introduction must not contain detailed history or long lists.
Example:
Arita ware (有田焼, Arita-yaki) is a Japanese porcelain tradition developed in the early 17th century in Saga Prefecture. It is known for its refined white clay, cobalt-blue underglaze painting, and strong export influence on European ceramics.
Historical Background
[edit]Covers:
- origins (century, founders, influences);
- key historical phases;
- political, economic, or cultural context;
- periods of innovation or decline.
This section may refer to historical periods (e.g., Edo period, Qing dynasty, Joseon era).
Materials
[edit]Describes:
- raw materials (clays, woods, metals, pigments, fibers);
- their geographic sources;
- preparation methods (refining, filtering, alloying, softening).
If relevant, describe regional variations.
Techniques
[edit]Explains:
- primary production process (step-by-step overview);
- specialized techniques (casting, weaving, throwing, carving, lacquering);
- unique or characteristic methods.
This section should be factual, not instructional.
Tools and Equipment
[edit](Required only if relevant)
Includes:
- traditional tools (e.g., bamboo brushes, kick wheels, chisels);
- specialized equipment (kilns, looms, furnaces).
Regional Variations
[edit]Describes differences across:
- prefectures or provinces;
- villages or workshops;
- regional schools or styles.
Each variation should be clearly marked with a subheading.
Cultural and Ritual Significance
[edit](Required only if applicable)
Explains:
- symbolic meaning;
- ritual or ceremonial uses;
- social status associated with the craft;
- relevance in traditional events or beliefs.
Modern Developments
[edit]Covers:
- contemporary artists and studios;
- revival efforts;
- museum collections;
- international influence;
- integration into modern design or industry.
Notable Objects or Types
[edit]A curated list of representative object forms connected to the craft.
Examples:
- flower vases
- incense burners
- sake cups
- sword fittings
Each item may link to its own article if available.
Gallery
[edit]Images must follow:
- preference for museum and open-licensed photographs;
- prohibition of AI-generated images (see Media & Image Usage Policy);
- proper licensing (CC, open access collections);
- accurate and neutral captions.
References
[edit]Every article must include:
- academic publications,
- museum catalogues,
- archaeological reports,
- authoritative dictionaries,
- peer-reviewed sources.
Websites may be included if reputable (museums, universities, cultural institutions).
Category Section
[edit]Articles must include:
- Mandatory categories
- a domain category such as [[Category:Ceramics]], [[Category:Metalwork]], etc.
- one or more geographical categories (country, region, prefecture)
- a historical period category when clearly applicable
- Optional categories (when applicable)
- period categories (e.g. [[Category:Edo period]])
- [[Category:Religious objects]]
- [[Category:Domestic objects]]
- [[Category:Sword objects]]
- technique or subfamily categories (e.g. [[Category:Porcelain]], [[Category:Stoneware]], [[Category:Bronze casting]])
Categories must follow the naming conventions defined in the Category System Specification.
Writing Tone and Style
[edit]- Use a neutral, academic tone similar to museum catalog descriptions.
- Avoid subjective adjectives (e.g., “beautiful,” “magnificent,” “stunning”).
- Avoid speculative statements.
- Prefer short, clear sentences.
- Introduce Japanese, Chinese, or other local terms with transliteration on first use.
Example:
- Correct
“The technique uses iron-rich clay sourced from the local river basin.”
- Incorrect
“This amazing technique beautifully uses clay from the area.”
Terminology Rules
[edit]Craft Names
[edit]- English name first
- Local name second (script + transliteration)
Example: Imari ware (伊万里焼, Imari-yaki)
Transliteration
[edit]Follow ISO or widely accepted museum standards:
- Japanese: Hepburn
- Chinese: Hanyu Pinyin
- Korean: Revised Romanization
Historical Periods
[edit]Always use standardized English period names:
- Edo period
- Meiji period
- Ming dynasty
- Joseon dynasty
Image Use and Caption Style
[edit]Captions must:
- describe the object factually;
- include century or approximate date;
- include material and technique if known;
- credit museums or sources when needed.
Example: “Porcelain bowl with underglaze blue decoration, Edo period (18th century). Arita ware. Image: Wikimedia Commons / CC BY-SA 4.0.”
Common Errors to Avoid
[edit]- mixing historical facts with modern interpretations;
- using inconsistent transliteration;
- overloading the introduction with details;
- missing categories;
- not citing sources;
- using subjective or promotional language;
- describing personal opinions.
Version History
[edit]- 1.1 – Replaced “craft article” with “Craftpedia article” and “article about a craft tradition”
- 1.0 – Initial release (English)