From c321193a759eb235ac7df11134f751fc13212887 Mon Sep 17 00:00:00 2001 From: LightArrowsEXE Date: Sun, 15 Sep 2024 05:30:35 +0200 Subject: [PATCH] astiob feedback --- docs/guidelines/editing.md | 204 ++++++++++++++++++++------ docs/guidelines/img/bad-ellipses.png | Bin 0 -> 5566 bytes docs/guidelines/img/good-ellipses.png | Bin 0 -> 2460 bytes 3 files changed, 158 insertions(+), 46 deletions(-) create mode 100644 docs/guidelines/img/bad-ellipses.png create mode 100644 docs/guidelines/img/good-ellipses.png diff --git a/docs/guidelines/editing.md b/docs/guidelines/editing.md index 3e20638..7f46761 100644 --- a/docs/guidelines/editing.md +++ b/docs/guidelines/editing.md @@ -1,12 +1,19 @@ # Editing Guidelines -!!! warning "Audience" +!!! warning "Target Audience" This document is written for an English-speaking audience. If you are not editing in English, a lot of the practices here may not apply to you. Always make sure to refer to widely-accepted style guides in the language you are editing in. +!!! danger "Editing Bible" + This document is not the Bible, + regardless of how authoritative it may sound in some sections. + Editing is a creative process, + and there are infinitely many schools of thought on how to best adapt a script. + This document is simply a style guide to help maintain a somewhat consistent style to Kaleido releases. + Editing plays a crucial role in fansubbing, helping to make the original text more accessible and ensuring the intended message is effectively conveyed. @@ -22,6 +29,11 @@ Deviations from these guidelines are often intentional, and may help give more character to a subtitle or fit the style of the original script better. +How close to this style guide scripts follow +depends on the script and the editor in charge of the project, +but the majority of Kaleido releases +should more or less follow this style guide. + ## Grammar and Punctuation Using proper grammar and punctuation is crucial for creating clear and engaging subtitles. @@ -132,12 +144,34 @@ Below is a quick overview of some common differences between British and America | Lift | Elevator | Besides dialect differences, -there are a couple other spelling rules that are worth noting: +there are a couple other "rules" Kaleido follows: + +!!! example "Other rules" + + === "All right/Alright" + + "Alright" is almost always spelled as "all right". + + This is the accepted spelling in published writing, + and is also the spelling we stick to. + While cases can be made for "alright", + it is always safer to use the accepted spelling. -- "Alright" should always be spelled as "all right". - This is because "alright" is only correct in specific cases, - while "all right" is always correct. -- "OK" and "Ok" should always be fully spelled out as "okay". + How closely the editor sticks to this rule + is up to their discretion, + and there's nothing essentially wrong with using "all right", + so long as it's not used as a blank stand-in. + + === "OK/Ok" + + "OK" and "Ok" should almost always be fully spelled out as "okay". + + This is strictly for aesthetic reasons, + and ultimately they mean the same thing. + If there's an "OK" signage on screen, + it may be appropriate to keep the abbreviation in dialogue as well, + but in almost any other case, + "okay" is preferred. ### Punctuation @@ -145,27 +179,122 @@ Proper use of punctuation is almost always required. Do not rely on punctuation used in the original Japanese script, as punctuation rules and styles vary greatly between languages. -- Avoid comma splices. - This is when multiple independent clauses are joined together with commas, - without any other punctuation to separate them. - These often result in run-on sentences, - which can be more difficult to read. -- Use the Oxford comma. - This is the comma before the "and" in a list of three or more items, - and reduces ambiguity. -- Use em dashes (—) for interruptions or abrupt changes in thought, - not hyphens (-) or double hyphens (--). -- Avoid ellipses like the plague. - They are almost always unnecessary, - annoying to read, - and can often be replaced with different punctuation. - The viewer can easily infer that information from the audio. -- Do not make use of the four-dotted ellipsis. -- Interrobangs are always written as "?!" in English, - never as "!?". - The latter is the Japanese punctuation. -- Brackets should be avoided as much as possible, - but can be used to better convey the intended meaning when necessary. +!!! example "Punctuation rules" + === "Comma splices" + + Avoid comma splices. + This is when multiple independent clauses are joined together with commas + without any other punctuation to separate them. + These often result in run-on sentences, + which can be more difficult to read. + + === "Oxford comma" + + The Oxford comma is highly preferred. + This will typically reduce ambiguity, + but [not always](https://www.scribbr.com/commas/oxford-comma/#appositives). + + If you are unsure if an Oxford comma will help, + it may be indicative that a line should be rewritten. + + === "Abrupt ends" + + Use em dashes (—) for interruptions or abrupt changes in thought, + not hyphens (-) or double hyphens (--). + + In the case of trailing off, + ellipses (...) may be used. + However, also consider whether a full stop (.) would be more appropriate. + + === "Ellipses spam" + + Avoid ellipses like the plague. + + Permit me to be so brazen as to break character and put my full hate on display here + (_we will continue with regular programming shortly_), + but ellipses are almost always unnecessary, + annoying to read, + and can usually be replaced with different punctuation. + + Spamming them every time the character has even a _slight_ pause + is not only annoying, + but may also give the viewer the wrong impression + about the character and the conviction put into the line, + and in the worst cases feels like you're positioning a speed bump + in front of the viewer while they're trying to read. + + The ellipsis has been abused by many scripts, + especially in the 2000s. + Thankfully, + many editors have started to catch on to this, + and it is becoming less common. + + Do not take this to mean that you should never use ellipses. + They can be fantastic tools if used sparingly to convey doubt or uncertainty, + or a character's trailing train of thought. + However, not every pause merits an ellipsis, + and they should absolutely _not_ be placed at the start and end + of every single incomplete line (looking at you, [a.f.k.]) + + !!! failure "Bad use of ellipses (thanks, [a.f.k.])" + ![Example of bad use of ellipses from a.f.k.'s Lucky Star 06 release](./img/bad-ellipses.png) + + Always consider whether a full stop or even a comma would be more appropriate, + or if a line even needs punctuation at all + (such as with broken lines that continue immediately after, + as is the case with every single line in the above example). + Sometimes a line can be rewritten to convey the intended meaning more clearly + without forcefully inserting an ellipsis. + + Naturally, in places where ellipses are required + (such as when a character continues another character's line), + they are completely fine to use. + + !!! success "Good use of ellipses" + ![Example of good use of ellipses from Kaleido's Blue Archive 01 release](./img/good-ellipses.png) + + _Also, never use the four-dotted ellipsis._ + + === "Japanese punctuation" + + It's not uncommon for Japanese punctuation + to slip into English scripts by accident, + especially in the past. + You should stay on the lookout for these, + and replace them with appropriate English punctuation where necessary. + Similarly, + you should try to avoid being beholden to the original punctuation, + as the rules differ between English and Japanese. + + Examples of this include: + + - Banginterros (!?) + + In English, it's standard to use interrobangs (?!) to convey surprise and shock, + whereas in Japanese banginterros (!?) are used instead. + While banginterros are occasionally found in English, + they are less standardised. + + - Wavy Dashes (~) + + In Japanese, the wavy dash (~) is often used to indicate a prolonged sound (like "Aah~"). + This is not used in English, + and should be avoided. + + - Long dashes (――――――) + + These serve a similar purposes to em dashes, + but can become rather extreme in use + (admittedly, these are more often found in visual novels than subtitles). + These should be replaced with appropriate punctuation, + which depends on the context they are used in. + + - 「 」 + + While these brackets look cool, + they are not used in English. + These signify quotes in Japanese, + and should be replaced with appropriatequotation marks. ### Quotation Marks @@ -350,25 +479,6 @@ and how you may go about rewriting them[^gardenpath]. !!! abstract "Explanation" Adding "individuals" makes it clear that the sentence is referring to a group of people. - === "Example D" - - !!! Quote "Example Sentence" - "While the girl sang the song pleased everyone." - - !!! abstract "Explanation" - The reader initially assumes that "the girl sang the song", - but the sentence is actually saying that the song pleased everyone while the girl sang. - - !!! note "Rewritten" - - "The song pleased everyone while the girl sang." - - "As the girl was singing, the song pleased everyone." - - "While the girl sang, the song pleased everyone." - - !!! abstract "Explanation" - - The first sentence clarifies that the song is the subject that pleased everyone
- - The second makes the timing clearer by indicating an ongoing action.
- - The third splits the clauses, separating "sang" and "the song".
- As illustrated above, there are a variety of ways to rewrite sentences to avoid garden-pathing: @@ -381,6 +491,8 @@ there are a variety of ways to rewrite sentences to avoid garden-pathing: - Eliminating unnecessary modifiers or adjectives - Using conjunctions ("and", "but", "or", "so", "for", etc.) +## TODO: rest of this + ## Characterisation - Maintaining character voice and personality diff --git a/docs/guidelines/img/bad-ellipses.png b/docs/guidelines/img/bad-ellipses.png new file mode 100644 index 0000000000000000000000000000000000000000..952a84d00ee28d7a0e2f8cc21c3561da9850cffe GIT binary patch literal 5566 zcmai2cOYEdwio47g6Jf=iRdFm2to87(Myy;V#3G}qa;KLA&54J5GA5BjFOmP2)=xu z#3)gsOc)YnL?^`P;+^B(`|f-9kN3_$`|Nf0S!eCF)^DxfJ_#1)hHNb7SZHWy*o=+z ztY~OxQ8YBC9x>4YlKH0;XJDwYFtgEbYim0OE;3q84NX2iRs-bV1;+zIJe&p)lF=u3 za6B0etU6f=iq+KMa5Z2Z8CXgK3XTB*8cqWTUPhzACvaebSEErQALH@Ic=9nBREI~y zK{dd7JfI#8yaQZ-_?V1`11j-wJaEB*2{0prYk?1`0V5uK2jBW3YJrA^r^i@N+vd^u zN;ZRU>?PKxqF1h5nLLikwRK#p4Kll%YGu;=BV%(s&(m=fX8-MNn}tDNXiHL_Cq=%8 z=xES)85OHj?;smadM0oj*EuV@oF#UTlH^=y0kvPV#f~D>duy)+hgc+r!(zXFH|!&x zRfUw(Rg(mh;lFAn=Kn%alJe4gaO11y)XltgGi+T2sQLbbDxp!#hk^9S1HpE zlrT1*?(}AxIW(0IjmhKZ#J5!n_!AQug$hIcBW-qV;z6WDf&~kUK5Ht zx*TqZs6yrqx%d<$%607qU%dS)z3P9Xm0?{PozITkHG}ZaLchn+?R=QTWH;Ux8ZwL- zS`15>y`26hTxQg$?#tt{{A*{INr2a!9lY<=o-tW;O3T=hzpJR5(ndHl4e^#Yfby#B z>hG228$jz{1~1*MhCRyzwq$gvmOJb8>x(s{pVd)PZ1G|xHD`3BeiPaJgIC1K&ogpb zH6MsJ3Wi&pgTR}^7K{x^aV^_@!HwQx@kP-$++-wdpHv*4x>~B0qhs9`a?Gz=Wf|Do z*5$@}GjGe8nQ41%Wn9y(Gx-*6#aB&3Xl{V^-r>YfFWgiuGJQ~-5hYemZufUm4vv_p z8)5%`m(bw!;hA%Iy=(h78;e!}>vHJGYcr)YBk_(tF4bebW!Gzb8M4wm0QYmy$$i>dxHlnEBnoBRr{A}_CKCW9^ex zEI2tVb1kdJ9@ba+*(~2y@eh%SD#qW!6~&qghqpZI#oT>YTNJzg^sDI^MpZPOs)m6; zd!s&wPG8WIOGv5@tB+X&a9bo%JmUQn-G&Yxz8W^^4wj z9b2@CWdO_G9jxDrA9YxU)ABY$jkS}1ZF|0TIfC1Y7H6le(|ukq1oj|S?qXf%ZQ9y! z{aD^UesXKkIxo9aqBqukuvn;xOzuqWsSSqla~T}+OuyC53iYl!#L4dF6}8JmD!E4I zk*pF!VdKGU*|u*dLyx8ai_sZ5@K)$os=oPOe>&Jfz4;S!1(EO5#Z~faNGd8>StQcK zhqRjeP3VD9ugbe|PtiW2ZUq^l&dFJjdpIsigUjFWOvuh&z>~0UAeuzax0p>>XndP< zJgg(4McL4&rxaPG!%LDte9lrVC6Q{YM)nB%`}Th{G1>h}U-?N^X$>E6K6oFFZmN5o zAv&@7u!|R$T4bw0vpi~bS{FK26K1E18fPqg;L|@X4kjIcE-x~0$fjHOyAU&-i!(NH z$}CY@ALGkgv92s$h#C2X(T`6*hp6eox>Z^9dy~jMgTCVjAWGOwnm5U0}u zHr$S~T?Q$!^orw+WVXRAhA(&rcx9S2#{<$JRF%geQQs&8h-Z8LF#?ljio*wi9P z-M5jy$^D!^i*=i{^)WmBxN_5@5W_&C8P!1-OEid2@|coiTe&4nzw2T_7rsC(&0Y)WAk`Fk*4S#R)}7e0RVQYmz~4r$8Uf? z7U)2D6FE2A|9Jy~T&K>93jq2*u@4TRtf5IaFeLR&T-YHEi0S>)tql}S{|)86JT2cx zAjoTs{C+E&Z97k z;y}?m!`Yak&YGL04xb_Uo(p^~)fKlX^kDD;jNP%<0*wpJ)y1^}jf*T~!hIO@x4d&u zZ*+An(L>U?gGcn=YQ7xJ7yZ^eQ&76hebt`qf!YGyKqwiQgVoEEVuI%45R1G)W1>Vt zZ%?PUeFA4#va!IB<8R}FM=apVs60~^MzQjj-C7jQ$Q17J2b5vOSEc4nOF@*A#}mFA zwhA&zAKjDlgnxPw7J0kAX;O$T&ODjf2%p|HG9z}ZRJ|AO7%8J2#`^^F@EqbIXnU1p z>)CP5u{Xx@tSo$*>CAqLZ$;J=+CvQVH_?hUZQE- zdh9?v6tbGrOj9Jp002A@5(fv4e*@s(pg;%s_ZrDovcr}tk=Kx*9;G^wveTDhZXsET zi?+v>xIk87<$B@ZYP(9RAXpv6mGdKxp@Y3lX@Y2f$isc9(Z3-;o=Hu9E;g)%eV@#X zqs=WlgkoV>_9V|jrLaxP*p&pPmYF}lzHvF%VWhw+kHs(3o0dw@wlsI^#f>LhO1`98 z3Sr7+jbeseFxbS`n3B#*JvU~zQOVBBqArsHrY#3Jk&uJ!s+%^8Bsrh6@5tdvsiy#2 z2m-#!*RLOJ%+3_Wmu2->*`@w87H%5+ZLIv2kJCh`Lim*r$4vo&OZjd#WNA^!;`^Q(y99=JA>U z7!J97-P;c5hedDjaRwcFKWd$&1bVuSRmMGwbY=XC!YO{d zahR$7+|_s1rKo`!E6FjS+55$gubvxwyubMNR_%Mw!!Ppp`;&!0mnKvsHq?2wYKBQm z*?S);Ict1yA@239q&k;zAMRZ--ykel)LzJV0*{}u;HBlGcHNCj+w2dn|EUN&o04bH z*9b$}d<-4)@p~mvPVKHp1I*2c-#^$H2n|2h%pJMiei=O+C4=H(T;jQRPLH(V<5&5+Ltm1Sa z!+uAx<7*IuLgtFay9cU8!TZ}srAK3;s-k0n;Y#mH?7v*r?%SSN0PQC0atOaY5>pv{ zB2=V{7X|b2q=>{k5&BSM%p~rh#7sf~lT)fXU|ydhOsBt?KB8{4O<(;4wGfH~3x~N6 zSMsPE#l}aT$W{=m=@C)=^8}`wk?35rE#ihuzC&j`$XbZTRZ>x~mG?cSGJE$EH13wi zvH0-5ei4Q1>yM4REw}30tMGCeC&wFL3Do;y`scRode@rT^@N!{KsCt_w|K5w~zsx`$ z%`$uImYOdX0b7k{JQuS?Xz0N_;0~f{nIAcCOY(m6sK0r3fjFo0;hHh8C(bq3;9_Ra zu35MNp`)-$se0Z4!vDY|>9Glj0@aatqqEtNtkVp_1kAc7dWg%Kjz!ftVs!Z$+xivI zwE4d-Fw>~0=_DLEca=*g5oIY4uc5B`ElZFADe{-Qpy+v?wT# zdNsVvyTnZlu%GfhZK$(?`UsXfky!Rqll~IGEZHga+Dr^PM`_*R`Qyx>!o@dnb)|Mx z{W9xH794blsd@8aNAx$97ttHnrhaI5V8^upYHIk0L^-2Qjsc4f<0f?(ul93Bg2c46 z`m~B`#2$Nr+gOqdDF*ly@)UgejbOp609e$SN{x+CDz>6BI16&Rw?auw&GeQUEkQ+Cc!P`JH9N4iYQ~%Y zkBa>d=7NUAfCW8i`SyPk9DwIMgrzoBEd6vPxR$p|Tefb=R{jzz(ExLx{Ay>kGt|VU zmczND7L$VWJ&tIKd=5TgMC~y@*iEoyAEJh*ctcX^2Ix#6TLoWzZ6zU~-{s!~B=g^gW@TFAgLPwzc$& zYN$DTZM|@_r90`Jn=M5f#Rh4x5P`h`)oH6_DaYzFzVhpJ|NOR_63!|B6~$d}y3qpLNND;}*s z%2arksh>a3%~7e7lVPrn7JgNSu#;oYD~UR+NRp)gt2P&luS#=z(?x$TV3p^d;K?DG ze|kNR-N%h1Lh_p6SK9r30!$;PaL#>j1i!y_@%dDL>tYQR?V~xyPjsEc9I*Eegji+i}uk-fUkA?Jb>h*U>v=;ht_RAWYB- zRQ?rWM}`@TKysY629S$oi+#UmbXxC(Xv~~6v)QK$w09o~`dw02YoI6rb(a>^%x3oN z1nK{0xm7)SbQGu*0rI{4{MaXwMQ1GTU2ea_Wef1>JO`KgET6*^{*&{bj#LvTk4f9Z zV7$|;{pd$y!d9lkr@2_lPml}hOI0xbDw*$5iiob-vQ^07Pfr6>`iYv&qP-4>#}V1@ z(L$O4Wif9uYRmFIL{Wwl0TO>l*L<_pY?fpzW)dmg<=&EiWX#Tkh5)CIFh$aCW)MQ^ zsIZkmHRS(6jL`4@g&2~Oc$~l%H9J&epS57I9w`N;S1gZ&2=cYrx3WZf(k5!v) zX?cdQx;Whr-{Cq5eu355PwNbyI0$Va@7M?fb7tlBK8n!c(91F=e=i2&a{5d0!DHrU z4R7af?@GFU^h_KycwSFaJ?xtkt(~TXXGolUmD4+Dz;-_db9+4}sIq3T;p6DT^^@kY zx;cl^^lNXem>XKc;>KI&UTiH6?d>g-`d?3e(~JmvOcuU{4SH%IbzV5#mlwxDpDu++ zi7t_IsJ^#Eo+}<5sm6UCZ~Oui{R6D`=!^;QAbNBf_yrIe9uN=`5+43grC>)JY92?u zza)!r=dhs)6PlADS;;x#^Y2Cz0+K+71LqxH!PYG3J4yNKv_u?LKg981&a`rax{N60 zE=P2n8aQR8kvxF4YK%u*>SR^@TwQW~2y^Q)A_N0(ZGO2 z22*@H{xdNm=|;rW{#`mSZKBA#X+u>T6&;^MK{uV&=-tS7&^{@*`=)FztzyVGl<=|y zF2f$`-Y>B*;HMo6#3@1<{@JX%qT|Q3u~&Nl17(nBZi0t;;PkYS7&;&LEwvUKhf@j zD%;*J!!MVot2o&Rbj;kHkS)L`bOdKa_9RO%&TXi|9;$4UzlL@D985N%UKSiglM62T z=YfIV*w$u@N>$=QLpq;Nh?G174<^#;Hb(#IZ+tg(nD*EvX$W)CSv1$dzplpm=6W?c HZqfe*J?)gI literal 0 HcmV?d00001 diff --git a/docs/guidelines/img/good-ellipses.png b/docs/guidelines/img/good-ellipses.png new file mode 100644 index 0000000000000000000000000000000000000000..11fd4af36d6899d3e47598d7c0532c425c28f0b6 GIT binary patch literal 2460 zcmYjT2{=@57oW^iT?uo`C#I5_NhxG4nxq*OjC;fIukTe(pkaND?gO&+T9iBpBUf+*T-7QtwcFx@^yM#;S9xp1&jqZRy4!%FN zsou6^Pmkab!>{~VTA9`mNBeVlowE||B1{UZI~|pbSh;CL{m7+vz+zO~s77OtYVAOw zFdg5?elCK=&w9KJVu~X4NES-n4Y3`EF zZcG2ZtS&xBl|eG>Q;1W1Ak`PbE{tPO&n;~!jXks}ff((y?r>VzDs0ny8zbkG%aZh9x?oZG9*0nbim#U;Ff2eYT9t zVDPE1CS!y^#~XwvYLeji4xL?;QST5<1r9{^jJ2lY6>!Wo!@4dF33q}w%*1!Zg+~rv zYG`lIZP)NDF{R_p3>4VwE{@p7_stn6uf06#$6b7aiMOWfraldycwBAdpW>>*T)bW@ zUfT8$B0~(##PATMm41{V%>3<189BVdkh4*at_l-xtWARPiLY#4Jvg%97j2sf{qwm)-_t=pP-%rv2F1|Af<1tZ)f^&t+=u!h(IXGBITO0U(Tz&V%&*xBJ zUqwpo!B|^^U=x+`Rd?JQb9Xh4FVYUZRD6*$w=~gt>Eeg}RU8P8DVVUcXNpanu2Xq; z8~F|CdWEZIn}*lb(?S&UM~VVGUZ(5y5yUc|D4H|5xd*Obf9YszZ!xK@Rb6!2!hz0< z<~h|7P^YIUgdF3*jgV_)GM?JU!baxfG+tlVd|V)ne=cql}UP1=5A#N*TJ#fZ!#9s$*U?Q^GjO44iD8f%Q)Qodof#3Y;5 zl4fj@d?xGKIkfQ6TbI9fLgbLKv+P;r8Vhw&-L7{^pmsPwFzeLf-<4A*0rr4$_G~cX z&s~tDw9nqKrW;cyAAi@nGU!}>%HU=5071d!^yweT+x^Wc&hmgB>}ICE=tY`9+{!Y? z58o5>1}27dz8LwK8jqPFdwp~#lia_`a-bwn6(&XP*D0EVz))8k1pl2k<#n~tEvK+q z6YiMGA^tR1uU~jm^Tk!*u`s64WxS>0_=4JI{d&fJU#;Y}CxG)CQ=eDd)Jh-C5;dNA>*pb{ey7CvAY#V=UhCBa~ zl!^^AQ?Ivk*mig_#?Mn7SzrkcjqAU6h;7U=O)YNvr`>zcZm9MGCz0=J(Hu`STMW_= zyY<>m$wtuEBH^XVgS;iY~ z#H?b=>k54J)cko&+^<}S++0>k5qfLb=oN>*O5^Ensn%=}THUG{~%8^bhRScyGDhUd>s&}wiowQ3p5FaJwB0KjO zj%TgDg?k=?CaGi@5@^}YJq*wuv`wyc;Y&{)*<$Q$K}$$QiZ9Zj(s-8m^8F}f&;3wY zu&G2|=UzdNew<^8<>iDm5Z`yw_L`DyC4g%0KPs04yBfW)qnEj_Gum+bK53!Ivf38 D5WbFn literal 0 HcmV?d00001