User Tools

Site Tools


en:styleguide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:styleguide [2016/01/06 03:56]
hantilles
en:styleguide [2019/01/07 19:43]
thore [Keep lines short]
Line 1: Line 1:
 +====== Style guide ======
 +
 +
 **In short:** \\ **In short:** \\
 **Control chars** – ()[]\*\* –: fewer are better \\ **Control chars** – ()[]\*\* –: fewer are better \\
 **Content:​** if applicable word for word \\ **Content:​** if applicable word for word \\
  
-These guidelines are the result of a lot of discussion including sing language interpreter also doing subtitles and a deaf person using subtitles. Also I used this (german): https://​www.ndr.de/​fernsehen/​service/​untertitel/​Untertitel-Standards,​untertitelstandards102.html+These guidelines are the result of long discussions that included ​sign language interpreter ​who also does subtitles and also a deaf person using subtitles. AlsoI used this (german): https://​www.ndr.de/​fernsehen/​service/​untertitel/​Untertitel-Standards,​untertitelstandards102.html
  
 The following was our common result: The following was our common result:
Line 10: Line 13:
 === In dialogs the person speaking has to be indicated === === In dialogs the person speaking has to be indicated ===
  
-Full names are only useful when first using them. After that please use a form of abbreviation. If you use first names or family names is up to you (different might be appropriate from talk to talk), but the prinpipal ​is always: the shorter the better!+Full names are only useful when first using them. After that please use a form of abbreviation. If you use first names or family names is up to you (different might be appropriate from talk to talk), but the principle ​is always: the shorter the better!
  
 == example: == == example: ==
-> Constanze Kurz: welcome\\ +<file plain> 
-*applause* ​\\ +Constanze Kurz: Welcome
-Kurz: nice to have you here! \\ +*applause* 
-Frank Rieger: ​also a warm welcome from me, too\\ +Kurz: Nice to have you here! 
-Rieger: … \\+Frank Rieger: ​Also a warm welcome from me! 
 +Rieger: … 
 +</​file>​
  
 == example: (only first/nick names are known) == == example: (only first/nick names are known) ==
-> Laura: Hi Alice! Hi Bob! \\ +<file plain> 
-B: Hi Laura, how're you? \\ +Laura: Hi Alice! Hi Bob! 
-A: Hi! \\ +B: Hi Laura, how're you? 
-L: I'm fine, thanks! ​\\+A: Hi! 
 +L: I'm fine, thanks! 
 +</​file>​
  
 === No parenthesis around names! === === No parenthesis around names! ===
Line 30: Line 37:
  
 == example: == == example: ==
-> - Hey, everything'​s fine? \\ +<file plain> 
-- yes, how about you? \\ +- Hey, everything'​s fine? 
-- all done and dusted ​\\ +- yes, how about you? 
-- then we'll see each other tomorrow!+- all done and dusted 
 +- then we'll see each other tomorrow! 
 +</​file>​
  
 === cuttings are allowed, but should be avoided === === cuttings are allowed, but should be avoided ===
Line 48: Line 57:
  
 == Examples: == == Examples: ==
-> *applause* ​\\ +<file plain> 
-> &#42;laughing&#42; \\ +*applause* 
-*loud laughing* ​\\ +*laughing* 
-*boo* \\ +*loud laughing* 
-*disquietness* ​\\ +*boo* 
-*phone ringing* ​\\+*disquietness* 
 +*phone ringing* 
 +</​file>​
  
 === explicit linebreaks in amara can be created with [Shift]+[Return] === === explicit linebreaks in amara can be created with [Shift]+[Return] ===
  
 == example: == == example: ==
-> Well, yes, thank you very much for your talk (linebreak) +<file plain> 
-*standing ovation*+Well, yes, thank you very much for your talk (linebreak) 
 +*standing ovation* 
 +</​file>​ 
 + 
 +=== Keep lines short === 
 + 
 +<WRAP center round important 60%> 
 +New! Additional Infos Jan 2019 
 +</​WRAP>​ 
 + 
 +In general subtitles can be easily read, if a line is not more than around 42 chars. 
 +Since we use and format the transcripts from the etherpads you don't have to take care of linebreaks. Please insert as few linebreaks as possible. Please only insert linebreaks for speaker changes or sounds and when the etherpad forces you to. 
 + 
 +In short: Fewer linebreaks is better. 
 +=== Intro and outro === 
 + 
 +The video intro for the talks as well as the credits can also be experienced acustically. As we'd like to have all subtitles have a minimum of corporate identity, we suggest you use for these: 
 + 
 +<file plain> 
 +*33C3 preroll music* 
 + 
 +*postroll music* 
 +</​file>​ 
 + 
 +for German respectively:​ 
 +<file plain> 
 +*33C3 Vorspannmusik* 
 + 
 +*Abspannmusik* 
 +</​file>​
  
 === Q&A === === Q&A ===
Line 66: Line 106:
  
 == example: == == example: ==
-> Herald Angel: We welcome to this talk Linus Torvalds, Richard Stallman, ​ \\ +<file plain> 
-*raging applause* ​\\ +Herald Angel: We welcome to this talk  
-Herald: … Bill Gates and Steve Jobs. \\ +Linus Torvalds, Richard Stallman, 
-*cautios applause* ​\\ + 
-Herald: And now have fun with the talk: "How does good software look like?" ​\\ +*raging applause* 
-Torvalds: Good evening ​\\ + 
-*applause* ​\\ +Herald: … Bill Gates and Steve Jobs. 
-Stallmann: Evening ​\\ + 
-*applause* ​\\ +*cautios applause* 
-Gates: Good evening ​\\ + 
-*applause* ​\\ +Herald: And now have fun with the talk:  
-Jobs: Evening ​\\ +"How does good software look like?"​ 
-*applause* ​\\ + 
-Stallman: Software must be free. That's the highest principle! ​\\ +Torvalds: Good evening 
-Gates: And how does the programmer make a living of it? Air and love? \\ +*applause* 
-Torvalds: My software is used on a huge bunch of devices and programmers are paid to develop that software, when it should be used on new devices. ​\\ + 
-Jobs: And what about the UI design? Only if it looks good software is also used! \\ +Stallmann: Evening 
-Stallman: I want to use the CLI! \\ +*applause* 
-Gates: To send users back to the hell of text, after they got to know graphical user interfaces … \\ + 
-Jobs: … which YOU stole from US! There'​s still a court decision pending! ​\\ +Gates: Good evening 
-Stallman: Good concepts are always copied and further developed, just like with the code. \\ +*applause* 
-Torvalds: That reminds me of a specific line of code that was actually copied from Linux to Windows: "if OPEN BRACKET …+ 
 +Jobs: Evening 
 +*applause* 
 + 
 +Stallman: Software must be free.  
 +That's the highest principle! 
 + 
 +Gates: And how does the programmer ​ 
 +make a living of it? Air and love? 
 + 
 +Torvalds: My software is used on a  
 +huge bunch of devices and programmers ​ 
 + 
 +are paid to develop that software, ​ 
 +when it should be used on new devices. 
 + 
 +Jobs: And what about the UI design? ​ 
 +Only if it looks good software is also used! 
 + 
 +Stallman: I want to use the CLI! 
 + 
 +Gates: To send users back to the  
 +hell of text, after they got to know  
 + 
 +graphical user interfaces … 
 + 
 +Jobs: … which YOU stole from US!  
 +There'​s still a court decision pending! 
 + 
 +Stallman: Good concepts are  
 +always copied and further developed, ​ 
 + 
 +just like with the code. 
 + 
 +Torvalds: That reminds me of a specific ​ 
 +line of code that was actually copied ​ 
 + 
 +from Linux to Windows: "if OPEN BRACKET … 
 +</​file>​
  
-=== If you have a talk which is totally mixed in two or more languages, then use the language "​Klingon"​ in amara (seriously) ===+=== If you have a talk which is totally mixed in two or more languages, then use the language "​Klingon"​ in amara (seriously)===
  
 Afterwards there can be a whole translation to english and german and whatever. Afterwards there can be a whole translation to english and german and whatever.
en/styleguide.txt · Last modified: 2020/09/19 22:03 (external edit)