[.book] [#Tipps und Tricks] [.chapter] [#Bit Struktur] [.article:bitmark--] [%please follow this structure when creating bits] •. **bit declaration including possible resources** (e.g. [.interview:bitmark++&audio]) •. **item** (e.g. [%A4a]) •. **instruction** (e.g. [!Listen to the reports and complete the information.]) •. **body** (= actual exercise incl. possible pictures etc. in case of bitmark++) •. if any: **resource** (e.g. [&audio:https://docs.bitbook.education/bit-books/schubert/schubert_erkundungen_b2/web-resources/audio/02_erkundungen_b2_3a.mp3]) •. if any: **comments** (e.g. ||"Discuss adapted instruction with publisher"|| [.chapter] [#General rules] [.article:bitmark--] • Allways read the documentation first. • The documentation, rules, ways we write bits might change, check the documentaion from time to time to be informed about the newest changes • When books are digitised every word/picture has to appear in the digitised version even if it will be cropped out of the actual app showing. Parts that do not make sense for the app version should be added under the .article bit and using ||excluded:….|| • Text editing can be made in the instruction when the bit has at least bitmark—-/++ attached Details: https://docs.bitbook.education/bitmark_bit/#instruction • Between the paragraphs of a text please introduce a clear line • In texts where we have added numbering make sure there is no space between the answer and his number |code:bitmark: Die ganze Reise [_ging][!losgehen][%2] schon mal mit einer vierstündigen Verspätung des Fluges [_los][%2]. Am Urlaubsort musste ich noch ungefähr eine Stunde auf ein Taxi [_warten][!warten][%3] • automatic numbering system doesn’t need a point after the number |code:bitmark: [%1]die Verhinderung des Anschlags == [$Der Anschlag wurde verhindert.] === [%2]die Vertretung des Direktors == [$Der Direktor wurde vertreten.] === For manual numbering this is necessary, but the easier way is to just add an * followed by a point. |code:bitmark: [^.cloze] •. einen Kontinent [_bereisen] •. in fremde Länder [_reisen] 3. in der Urlaubszeit [_verreisen] 4. in einem fremden Land [_herumreisen] [.chapter] [#Frequent issues and mistakes:] [.article&image] • Double spacing, at the end of a chapter or so check with the search feature ( ctrl+F) if there is double/triple etc spacing and erase it. Also look after spacing in places where it is not necessary, it might be an issue for the parser. [&image:https://docs.bitbook.education/bit-books/gmb/tipps/web-resources/images/4.png] [.article:bitmark++] • [^%number followed by a point as in [%1.] is wrong. We use either [^%1] or 1. [.article:bitmark++] • Image link or source often incomplete, a sign missing or incorrect path. To verify this copy the link and try opening it. If the right image opens the link and path is correct and there might be other issues. [.article:bitmark++] • Sometimes when copying a text it is already formatted to have new lines even if there is no need for them in our bit. Please check if that's the case and erase the extra lines or spacing. [.article:bitmark++] • Not all bit types are yet adapted for the sandbox so please don't freak out if it doesn't look alright. Here you have some bits that usually are not well translated to the sandbox yet if the bit is well written it shouldn't be a problem later. Here you have some examples of such bits. [.match-matrix] [%C6] [!Setzen Sie die Verben in die angegebenen Zeitformen.] === [#] == [#Präsens] == [#Präteritum] == [#Perfekt] === [%1]arbeiten == [!ich]arbeite[@example] == [!er]arbeitete == [!ihr]habt gearbeitet === [%2]wissen == [!er]weiß == [!wir]wussten == [!Sie]haben gewusst === [.match-matrix] [%A5b] [!Länder und Einwohner Benennen Sie die Einwohner (männlich/weiblich und im Plural) der ausgewählten Länder.] === [#Land] == [#männlicher Einwohner] == [#Einwohnerin] == [#Einwohner (Plural)] === ◇ Irland == der Ire[@example] == die Irin[@example] == die Iren[@example] === [%1]Litauen == der Litauer[@example] == die Litauerin == die Litauer === [.article:bitmark++] • Sometimes an exercise can be transformed into multiple bit types. Choose the one that makes most sense to the exact exercise you are converting. Other times, but these are rare exceptions, only a group of bits can properly express an exercise. [.article:bitmark++] • Use [^@shortAnswer] when the answer to an interview or match bit is supposed to be pretty short. This happens pretty often, don’t be afraid to use it. If the question has potential for a longer answer add nothing special. For Interviews with multiple tasks that require a longer answer add [^@longAnswer] [.article:bitmark++] • [.cloze] bit and 2 part answers come up sometimes. In this case you only add the full answer to one of the gaps as shown in this example: [.cloze] Teil der Armee [_stehe][%10] für Aufräumungsarbeiten [_bereit][!bereitstehen][%10]. Die Regierung [_richte][%11] ein Spendenkonto [_ein][!einrichten][%11], von dem aus unbürokratische finanzielle Hilfe möglich ist. [.chapter] [#How to tipps] [.article:bitmark++] __How to add examples__ Two ways of adding examples to exercises are: [@example: Example text] and [@example] next to and answer bubble. Usually these are interchangeable but the sandbox might not be yet adapted to accept both for each bit type. Also in the [@example: **can contain bold** and __italic__ as in this example] Some examples: |code:bitmark: [^.interview] [^%A2] [^!Bilden Sie Fragen zu den vorgegebenen Antworten.] === ◇ Ulrike Lipka.[@shortAnswer] [@example:Wie heißen Sie? Wie ist Ihr Name?] === [^.cloze-solution-grouped] [^%A9] [^!Ergänzen Sie die passenden Nomen.] Andreas war ein [_Musterschüler][@example]. [^.match-solution-grouped] [^%A8c – Wortschatz: Schule und Ausbildung] [^!Ordnen Sie das passende Verb/die passenden Verben zu.] === [%1] auf eine Schule == [%b]gehen[@example] === [.article:bitmark++] __How to add an article to a bit__ There are a few different ways to add a text to a bit. Here are some guidelines for when you’re not sure what when to use. If the entire bit Is made up of an article then you can use an .article or .assignment bit. If the bit has an exercise and an article you can use an info/note label on an &article. If the text is short the recommendation is to just write it after or before the actual exercise. Keep in mind that info/note labels are compatible only with the more advanced form of bitmark (bitmark++) and it is important to keep it as simple as often possible. [.article:bitmark++] __How to add images__ If you have just one image to add use the bit type followed by &image as in [^.cloze&image]/ [^.cloze:bitmark--&image]. For multiple picture make sure they all are essential and only then use the bit followed by bitmark++. This allows for multiple images, but should be the last choice. [.article:bitmark++] __How to digitalize crossword puzzles/ kreuzworträtsel__ For the moment there is no perfect bit to fit this type of exercise but **[.cloze]** is used as in the following example: |code:bitmark: [^.cloze] [^%A27 – Wortschatz] [^!Liebe und Leid Lösen Sie das Worträtsel. Suchen Sie die passenden Nomen. Das Lösungswort ergibt sich, wenn Sie die markierten Kästchen senkrecht lesen.] [^%1] Das hat man, wenn der geliebte Partner/die geliebte Partnerin nicht da ist. [_S][@example] [_e][@example] [_h][@example][^%1] [_n][@example] [_s][@example] [_u] [_c] [_h] [_t] [^%2] Das Brautpaar muss sie während der Feier anschneiden, dann kann man sie essen. [_T] [_o][^%2] [_r] [_t] [_e] [^%3] Das machen viele Singles, manche online. [_P][@example] [_a][@example] [_r] [_t] [_n] [_e] [_r] [_s] [_u] [_c] [_h] [_e][^%3] [^%4] Man trägt ihn normalerweise, wenn man verheiratet ist. [_E] [_h][^%4] [_e] [_r] [_i] [_n] [_g][@example] [^%5] Man empfindet ihn, wenn die Ehe nicht gut geht und man sich trennt. [_T] [_r] [_e] [_n] [_n] [_u] [_n] [_g] [_s] [_s][@example] [_c][@example] [_h][@example] [_m] [_e] [_r] [_z][^%5] [^%6] Die Braut trägt es während der Hochzeit, es ist oft weiß. [_B][@example] [_r][@example] [_a] [_u] [_t] [_k] [_l] [_e][^%6] [_i] [_d] [^%7] Das hat man zum Beispiel, wenn man in jemanden verliebt ist und die Liebe nicht erwidert wird. [_L][@example] [_i][^%7] [_e] [_b] [_e] [_s] [_k] [_u] [_m] [_m] [_e] [_r] [^%8] Der, der die Braut heiratet. [_B] [_r] [_ä][@example] [_u][@example] [_t][^%8] [_i] [_g] [_a] [_m] Lösung: [_H][!1][@example] [_o][!2] [_c][!3] [_h][!4] [_z][!5] [_e][!6] [_i][!7] [_t][!8] [&image:https://docs.bitbook.education/bit-books/gmb/tipps/web-resources/images/2.png] [&image:https://docs.bitbook.education/bit-books/gmb/tipps/web-resources/images/3.png] [.article:bitmark--] __How to add links and documents__ use :bitmark++ ore .article++ for documents: https://docs.bitbook.education/bitmark_resources/#document for links: https://docs.bitbook.education/bitmark_text/#external-links [.chapter] [#When what bit type to use] [.article:bitmark++] **.multiple-choice** is usually used for a few questios reffering to a text .multiple-choice-1 is to be used for a single question/bit, if there is an entire test of for than 7 multiple choice questions then a bit for every question is the best way to go. **.multiple-choice-text/.cloze-and-multiple-choice-text** can also be used for text where there are basically the same answers to choose from. |code:bitmark: [^.cloze-and-multiple-choice-text:bitmark--] [^%A27] [^!Ergänzen Sie __Sie__ oder __Ihnen__.] 1. Kann ich [+Sie][-Ihnen] morgen zurückrufen? 2. Ich werde [-Sie][+Ihnen] die Ergebnisse noch heute mailen. 3. Wir konnten [+Sie][-Ihnen] leider nicht eher benachrichtigen. For grammar parts where the student should choose, case, number etc such a bit can ease the process as in the following example [&image:https://docs.bitbook.education/bit-books/gmb/tipps/web-resources/images/8.png] **.match-solution-grouped** is the best bit to use for exercises where you have to match words from two different categories such as: |code:bitmark: [^.multiple-choice-text] [^%A28c2] [^!Das Privatleben von Prominenten In welchem Genus, Kasus und Numerus steht die Nomengruppe?] des berühmten Sängers [+maskulin][-feminin][-neutral] [+singular][-plural] [+Genitiv][-Akkusativ][-Nominativ][-Dativ], In der letzten Zeit [-maskulin][+feminin][-neutral] [+singular][-plural] [-Genitiv][-Akkusativ][-Nominativ][+Dativ] [&image:https://docs.bitbook.education/bit-books/gmb/tipps/web-resources/images/1.png] In cases where there is a defined correct answer [.match] bits should be used Where there are open questions with suggested answers the [.interview] + [$] should be used **.interview** This bit has 2 types of possible answers _ are answers that are compared to the user input If the input is equal to one of the answers the feedback to the user is that his answer was correct (green), wrong otherwise $ answers are a hint to the user. A sample solution. It's not taken into account for giving feedback, right/wrong [.chapter] [#Templates] [.article:bitmark++] Anchor templates |code:bitmark: [^.internal-link] [^!Zusatzübungen zu Modalverben ➔ Teil C][►kapitel1c] [^.chapter][▼kapitel1d] [.article:bitmark++] Audio and Image ressources |code:bitmark: [&image:https://docs.bitbook.education/bit-books/schubert/schubert_erkundungen_b2/web-resources/images/schlafen-neu.jpg] [&audio:https://docs.bitbook.education/bit-books/schubert/schubert_erkundungen_b2/web-resources/audio/10_erkundungen_b2_3a.mp3]