Changes between Version 36 and Version 37 of EnglishStyleGuide
- Timestamp:
- Jan 13, 2019, 8:18:54 PM (5 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
EnglishStyleGuide
v36 v37 2 2 3 3 This guide provides some ground rules to write user-facing texts for '''0 A.D.''' 4 4 5 5 6 == Calender years … … 8 9 However, dots are not used when writing down years. E.g. Augustus was emperor of Rome from 27 BC until his death in 14 AD. 9 10 10 11 ||=Good =||=Bad =|| 12 ||BC ||B.C., BCE, B.C.E. || 13 ||AD ||A.D., CE, C.E. || 14 11 ||='''Good''' =||='''Bad''' =|| 12 ||BC ||B.C., BCE, B.C.E. || 13 ||AD ||A.D., CE, C.E. || 15 14 16 15 … … 27 26 For example: 28 27 29 ||= Good =||=Bad=||30 ||Click the Citizen Soldier icon ||Click the CITIZEN SOLDIER icon||31 ||Hold Shift and click ||Hold shift and click||28 ||='''Good''' =||='''Bad''' =|| 29 ||Click the Citizen Soldier icon ||Click the CITIZEN SOLDIER icon || 30 ||Hold Shift and click ||Hold shift and click || 32 31 33 32 … … 36 35 Mind the difference between the cursor (virtual) and the mouse (physical). 37 36 38 39 == English Orthography40 41 Use US English spelling.42 43 For example:44 45 ||=US =||=UK =||46 ||analyze ||analyse ||47 ||armor ||armour ||48 ||artifact||artefact ||49 ||defense ||defence ||50 ||finalize||finalise ||51 ||gray ||grey ||52 ||plow ||plough ||53 ||traveler||traveller||54 37 55 38 == Dynastic factions … … 61 44 ||Ptolemy ||Ptolemies ||Ptolemaic || 62 45 ||Seleucus ||Seleucids ||Seleucid || 46 47 48 == English Orthography 49 50 Use US English spelling. 51 52 For example: 53 54 ||='''US''' =||='''UK''' =|| 55 ||analyze ||analyse || 56 ||armor ||armour || 57 ||artifact ||artefact || 58 ||defense ||defence || 59 ||finalize ||finalise || 60 ||gray ||grey || 61 ||plow ||plough || 62 ||traveler ||traveller || 63 64 Also, the verb ''to pronounce'' is always spelled with ''ou'', but the noun ''pronunciation'' is spelled with only ''u''. 65 63 66 64 67 == Terminology … … 81 84 === Actions 82 85 83 ||= Good =||=Bad=||84 ||Build (structures) ||||85 ||Collect (treasures) ||||86 ||Construct (ships, siege weapons) ||Build, produce, train||87 ||Gather (resources) ||Collect, get||88 ||Research (technologies) ||||89 ||Train (human units) ||Build, construct, recruit, produce||86 ||='''Good''' =||='''Bad''' =|| 87 ||Build (structures) || || 88 ||Collect (treasures) || || 89 ||Construct (ships, siege weapons) ||Build, produce, train || 90 ||Gather (resources) ||Collect, get || 91 ||Research (technologies) || || 92 ||Train (human units) ||Build, construct, recruit, produce || 90 93 91 94 === GUI 92 95 93 ||= Good=||=Bad=||94 ||Icon ||Portrait||96 ||='''Good''' =||='''Bad''' =|| 97 ||Icon ||Image, Picture, Portrait, Sprite, Thumbnail || 95 98 96 99 === Stats 97 100 98 ||= Good=||=Bad=||99 ||Health ||Hitpoints, HP||101 ||='''Good''' =||='''Bad''' =|| 102 ||Health ||Hitpoints, HP || 100 103 101 104 === Structures 102 105 103 ||= Good =||=Bad=||104 ||Structure ||Building ||105 ||Blacksmith ||Armoury ||106 ||Civic Center ||Civic Centre, Civil Center, Civil Centre ||107 ||Dock ||Harbour, Pier, Port, Quay, Shipyard, Wharf ||108 ||Farmstead ||Farmhouse, Granary, Mill ||109 ||Fortress ||Castle, Citadel, Fort, Stronghold ||110 ||House ||Dwelling, Home, Shack ||111 ||Storehouse ||Drop Site, Mining Camp, Storage Pit ||106 ||='''Good''' =||='''Bad''' =|| 107 ||Structure ||Building || 108 ||Blacksmith ||Armoury || 109 ||Civic Center ||Civic Centre, Civil Center, Civil Centre || 110 ||Dock ||Harbour, Pier, Port, Quay, Shipyard, Wharf || 111 ||Farmstead ||Farmhouse, Granary, Mill || 112 ||Fortress ||Castle, Citadel, Fort, Stronghold || 113 ||House ||Dwelling, Home, Shack || 114 ||Storehouse ||Drop Site, Mining Camp, Storage Pit || 112 115 113 116 === Units 114 117 115 ||= Good =||=Bad=||118 ||='''Good''' =||='''Bad''' =|| 116 119 ||Cavalry ||Cavalry Soldier, Horse, Horseman || 117 120 ||Champion || || … … 134 137 ||Siege Weapon ||Siege Engine, Siege || 135 138 139 136 140 == Unicode 137 141 … … 140 144 For example: 141 145 142 ||= Good =||=Bad =||=Usage=||143 ||… (U+2026, ellipsis) ||... (three full stops) ||intentional omission ||144 ||• (U+2022, bullet) ||- (hyphen) ||itemization ||146 ||='''Good''' =||='''Bad''' =||='''Usage''' =|| 147 ||… (U+2026, ellipsis) ||... (three full stops) ||intentional omission || 148 ||• (U+2022, bullet) ||- (hyphen) ||itemization || 145 149 ||– (U+2013, en-dash) ||- (hyphen) ||range of values (500–1 BC), oppositions (Greco–Persian wars) || 146 ||— (U+2014, em-dash) ||- (hyphen) ||source of a quote || 147 ||− (U+2212, minus) ||- (hyphen) ||substraction, negative values || 148 ||× (U+00D7, times) ||x (X) ||multiplication || 149 ||“ (U+201C) ||" (programmer's quote) ||start of a quotation || 150 ||” (U+201D) ||" (programmer's quote) ||end of a quotation || 151 ||‘ (U+2018) ||' (apostrophe) ||start of a quotation inside a quote || 152 ||’ (U+2019) ||' (apostrophe) ||end of a quotation inside a quote || 153 150 ||— (U+2014, em-dash) ||- (hyphen) ||source of a quote || 151 ||− (U+2212, minus) ||- (hyphen) ||substraction, negative values || 152 ||× (U+00D7, times) ||x (X) ||multiplication || 153 ||“ (U+201C) ||" (programmer's quote) ||start of a quotation || 154 ||” (U+201D) ||" (programmer's quote) ||end of a quotation || 155 ||‘ (U+2018) ||' (apostrophe) ||start of a quotation inside a quote || 156 ||’ (U+2019) ||' (apostrophe) ||end of a quotation inside a quote || 154 157 155 158 However, [[Atlas_Manual|Atlas]] [https://trac.wildfiregames.com/ticket/4936 does not support Unicode], so English strings of map files (e.g. anything under `binaries/data/mods/public/maps/`) should not contain Unicode characters for the time being. But you should avoid using combinations of ASCII characters to try and reproduce Unicode characters as well. Be creative, try to rephrase the content in question so that Unicode characters are not necessary.