OnSong^® Mappe

OnSong^® Bindefilformat er, hvordan OnSong flytter en sang, et sæt eller en hele bog mellem biblioteker. Som OnSong^® Archive indeholder det alt, hvad der er nødvendigt for at genskabe indholdet et andet sted — sangteksten, vedhæftelser, stilarter, indstillinger, transponering og anmerkninger — men hvor et arkiv er en enkelt uigennemsigtig blob, er en binder en mappe med almindelige filer. Det gør den læsbar, inspicerbar og i stand til at bære det medie, som en sang afhænger af, sammen med sangen selv på en platformuafhængig måde.

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

Hvad Der Er Indeni

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

• manifest.json — varen selv, serialiseret. Hver egenskab OnSong kender til det, i den samme form som OnSong web API'en bruger.
• Dens fil, hvis den har en. En vedhæftelse beholder sit oprindelige filnavn, så en PDF eller en MP3 indeni en binder er blot denne PDF eller MP3.
• Mapper til dens underordnede, navngivet efter hvad de er — songs, attachments — hver indeholder flere mapper med præcis samme struktur.

Den struktur gentages hele vejen ned: et sæt indeholder sange, en sang indeholder vedhæftelser, og hver er en mappe med sit eget manifest ved siden af sine egne filer. En binder, der indeholder en bog med to hundrede sange, har samme format som en, der indeholder et enkelt akkordskema.

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

Hvad Det Bærer

• Sange — akkordskemaet og alt, hvad der er knyttet til det.
• Sæt — sangene i deres rækkefølge, med sættets eget arrangement.
• Bøger — en hele samling.
• Vedhæftelser — PDF'er, billeder, lyd og alle andre filer tilknyttet en sang. Du kan vælge at medtage kun de vedhæftelser, der faktisk er i brug, i stedet for hver version, der nogensinde er tilføjet.

Binder Eller Arkiv?

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

• OnSong^® Archive er det ældre format, og er hvad du skal bruge for 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 indeni.

Import Og Eksport

Bindere importeres på samme måde som enhver anden fil: åbn en fra Filer, Mail, AirDrop eller en skybaseret tjeneste 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, brug Del og vælg OnSong Binder som formatet.

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

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