OnSong^® Binderomslag

OnSong^®-binderfilformatet er hvordan OnSong flytter en sang, et sæt eller en hel bog mellem biblioteker. Som OnSong^®-arkivet indeholder det alt, hvad der er nødvendigt for at genopbygge indholdet et andet sted — sangenes tekst, vedhæftninger, stilarter, indstillinger, transponering og annotationer — men hvor et arkiv er en enkelt uigennemsigtig blob, er en binder en mappe med almindelige filer. Det gør det læseligt, inspicerbart og i stand til at bære de medier, som en sang afhænger af, sammen med sangen selv på en platformsuafhængig måde.

OnSong^®-binderfilformatet har en filtypenavn på enten .onsongbinder eller .binder, og en MIME-type på application/onsong-binder.

Hvad er indholdet?

En binder er et ZIP-arkiv. Pak en ud, og du finder en mappe navngivet efter varens identifikator, indeholdende:

• manifest.json — selve elementet, serialiseret. Hver egenskab som OnSong kender det, i samme form som OnSong web-API'en bruger.
• Dets fil, hvis den har en. En vedhæftning beholder sit oprindelige filnavn, så en PDF eller en MP3 inde i en binder er bare denne PDF eller MP3.
• Mapper for dets underordnede, navngivet efter hvad de er — songs, attachments — hver indeholdende flere mapper af nøjagtigt samme form.

Denne struktur gentages hele vejen ned: et sæt indeholder sange, en sang indeholder vedhæftninger, og hver er en mappe med sit eget manifest ved siden af dets egne filer. En binder med en bog på to hundrede sange har samme format som en med et enkelt lead sheet.

Inden i et manifest er referencer til underordnede markeret med et $binder.præfiks, så en læser kan skelne mellem en værdi, der tilhører elementet, og en, der peger ind i en mappe ved siden af det.

Hvad den indeholder

• Sange — akkorddiagrammet og alt hvad der er vedhæftet det.
• Sæt — sangene i deres rækkefølge, med sættets egen arrangement.
• Bøger — en hel samling.
• Vedhæftninger — PDF'er, billeder, lyd og enhver anden fil, der er tilknyttet en sang. Du kan vælge at inkludere kun de vedhæftninger, der faktisk er i brug i stedet for alle versioner, der nogensinde er tilføjet.

Binder eller arkiv?

Begge round-trip et biblioteks indhold trofast, så valget handler om hvad du har brug for fra filen:

• OnSong^®-arkivet er det ældre format og er hvad der skal bruges til kompatibilitet med tidligere versioner af OnSong.
• OnSong^®-binder er det nuværende. Brug det til deling med nyere versioner af OnSong — og når du ønsker en fil, du kan åbne og se ind i.

Import og eksport

Bindere importeres på samme måde som enhver anden fil: åbn en fra Filer, Mail, AirDrop eller en skylagringstjeneste og vælg OnSong. Import af en binder, der indeholder et sæt, genskaber sættet og hver sang i det; import af en, der indeholder en enkelt sang, tilføjer denne sang.

For at oprette en skal du bruge Del og vælge OnSong-binder som formatet.

Bindere er også hvad OnSong Connect sender mellem enheder, når en enhed spørger en anden om en sang eller et sæt, så det samme format, der bor i din Filer-app, er det, der rejser over netværket.

Fordi en binder er en ZIP af almindelig JSON og normale mediefiler, er det det rigtige format at nå til, når du har brug for at se hvad OnSong faktisk gemte — eller når noget har brug for at læse dit indhold og ikke er OnSong.