Jinsi ya kuleta madokezo ya Markdown ndani ya JW Library
Geuza mafaili ya .md kutoka Obsidian, Notion au kihariri chochote cha Markdown kuwa madokezo halisi ya JW Library, yaliyowekwa kwenye mstari sahihi — bila malipo, kwa faragha, ndani ya kivinjari chako.
JW Library haina njia ya kuingiza maandishi. Unaweza kuandika madokezo ndani ya programu, lakini dokezo lililoandikwa mahali pengine popote — ndani ya Obsidian, ndani ya Notion, ndani ya faili la maandishi sahili kwenye kompyuta yako — halina njia yoyote ya kuingia kwenye maktaba yako. Watu huyaandika upya, au hukata tamaa na kubaki na seti mbili za madokezo ya funzo ambazo hazikutani kamwe.
JW Sync huziba pengo hilo. Pakia nakala rudufu kwenye Kichunguzi cha Funzo, bonyeza Leta Markdown, nayo mafaili yako ya .md huwa madokezo halisi ndani yake: kichwa, tarehe na lebo vikiwa vizima, na — faili linaposema ni andiko lipi linalohusika — likiwa limeambatishwa kwenye mstari huo, sawasawa kama ungeliandika dokezo ndani ya programu ukiwa unalisoma.
Hufanya kazi pande zote mbili. Madokezo yaliyohamishwa kutoka tovuti hii hubeba kitabu, sura na mstari wake, kwa hiyo hurudi hasa mahali yalikotoka. Madokezo yaliyoandikwa mahali pengine kwa kawaida hayabebi chochote cha aina hiyo, kwa hiyo ukurasa huu unaeleza mstari mmoja au miwili inayoyaweka — na nini hutokea faili linapokosa mistari hiyo.
Hatua kwa hatua
Tengeneza nakala rudufu katika JW Library
Fungua JW Library, nenda Funzo la Kibinafsi, gonga menyu ya vitone vitatu, chagua Nakala Rudufu na Kurejesha, kisha Tengeneza nakala rudufu. Hiyo hukupa faili la .jwlibrary — maktaba ambayo madokezo yako yataongezwa ndani yake.
Fungua Kichunguzi cha Funzo
Nenda jwsync.org, fungua Kichunguzi cha Funzo, kisha upakie faili hilo la .jwlibrary. Kila kitu hufanyika ndani ya kivinjari chako; faili halipakiwi kamwe.
Bonyeza Leta Markdown
Kitufe kiko kando ya Hamisha Markdown. Chagua mafaili mengi ya .md upendavyo, au faili la .zip lenye hayo — ikiwa ni pamoja na .zip ambalo tovuti hii hutoa unapohamisha.
Soma muhtasari kabla ya chochote kuandikwa
Unaambiwa ni madokezo mangapi yatatua kwenye mstari, mangapi yataongezwa kama madokezo yasiyoambatishwa, na mangapi tayari yamo kwenye nakala yako rudufu nayo yatarukwa. Chochote ambacho tovuti ilibidi kukikisia huorodheshwa mstari mmoja kwa wakati, pamoja na kisanduku cha kuweka alama, ili wewe uamue badala ya kugundua baadaye.
Hamisha kisha urejeshe
Bonyeza Hamisha .jwlibrary, kisha urejeshe faili hilo katika JW Library kupitia Nakala Rudufu na Kurejesha → Rejesha. Madokezo yako uliyoleta sasa ni sehemu ya maktaba yako kwenye kifaa hicho.
Faili fupi zaidi linalofanya kazi
Faili la Markdown halihitaji chochote kabisa ili kuletwa — faili lenye maandishi tu huwa dokezo, likichukua kichwa chake kutoka kichwa cha kwanza au, likikosa hicho, kutoka jina la faili. Kila kitu zaidi ya hapo ni kuhusu kuiambia tovuti dokezo linapohusika. Faili kamili huonekana hivi: --- title: Kikombe alichoomba kuhusu tags: [funzo, gethsemane] publication: Matthew 26:39 --- Sala yake inaonyesha utii, si kusitasita. Kizuizi kilicho kati ya mistari miwili ya vistari huitwa front matter. Mistari iliyo chini yake ni dokezo lenyewe.
Sehemu inazozisoma
Ni vitu vitano tu vinavyosomwa, na kila kimoja kina tahajia kadhaa zinazokubalika ili usilazimike kukumbuka moja hasa. **title** (au name, heading) huwa kichwa cha dokezo. **tags** (au tag, keywords, categories, labels, topics) huwa lebo halisi za JW Library, zikitengenezwa kama hazipo bado. **date** (au created, modified) huweka tarehe ya dokezo; chochote chenye YYYY-MM-DD hueleweka. **publication** (au pub, reference, ref, scripture, citation, source, passage) ndipo unapoandika mstari. **book**, **chapter** na **verse** (au ch, v, vs, verses) hufanya kazi ileile katika sehemu tofauti. Sehemu nyingine yoyote unayoiweka kwa madhumuni yako mwenyewe — author, status, chochote kihariri chako huongeza — hupuuzwa badala ya kuchukuliwa kuwa hitilafu.
Njia tatu za kuelekeza dokezo kwenye mstari
Andika rejeleo kwenye mstari mmoja: `publication: Matthew 26:39`. Au ligawe: `book: Matthew`, `chapter: 26`, `verse: 39`. Au tumia zote mbili — ndivyo uhamishaji wa tovuti hii yenyewe hufanya, ili faili lisomeke vizuri kwa binadamu na lichanganuliwe hasa kwa mashine. Njia zote tatu hutoa matokeo yaleyale, kwa hiyo tumia ile inayolingana na kihariri unachoandikia.
Rejeleo linaweza kuwa huru kiasi gani
Majina ya vitabu hulinganishwa kwa ukarimu. Majina kamili hufanya kazi, vivyo hivyo vifupisho ambavyo watu huandika kihalisi: Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalm pamoja na Psalms, Song of Songs pamoja na Song of Solomon. Kitenganishi kati ya sura na mstari kinaweza kuwa nukta mbili, nukta au herufi v — `John 3:16`, `John 3.16` na `1 Cor 13 v4` vyote husomwa vivyo hivyo. Nafasi si lazima popote, kwa hiyo `1Cor13:4` ni sawa. Front matter yenyewe ni huru vivyo hivyo. Funguo zinaweza kuandikwa kwa herufi kubwa. Nafasi baada ya nukta mbili inaweza kukosekana. Nafasi na tabu za ziada hupuuzwa, vivyo hivyo alama za nukuu kuzunguka thamani na maoni ya # yaliyo mwishoni. Miisho ya mstari ya Windows ni sawa. Unaweza hata kuacha vizuizi vya --- kabisa na kuanza faili moja kwa moja na sehemu, mradi tu mstari wa kwanza kabisa uwe mojawapo ya majina yanayotambulika — kanuni hiyo ipo ili dokezo linaloanza kwa sentensi ya kawaida yenye nukta mbili lisipoteze aya yake ya kwanza.
Lebo, jinsi utakavyoziandika
Zote hizi hutoa lebo zilezile mbili: `tags: [funzo, greek]`, `tags: funzo, greek`, `tags: funzo; greek`, `tags: #funzo #greek`, au orodha kwenye mistari yake chini ya `tags:` kila kipengele kikianza kwa kistari. Lebo zilizopo tayari kwenye maktaba yako hutumiwa tena badala ya kuongezwa mara mbili, kwa hiyo dokezo lililoletwa hujiunga na lebo ileile unayochujia tayari.
Nini hutokea kitu kinapokuwa hakiko wazi
Hakuna kisicho na uhakika kinachoamuliwa kwa niaba yako. Ikiwa jina la kitabu liko karibu na halisi lakini si sahihi kabisa — `Mathew`, `Ecclesiates` — dokezo haliwekwi kiotomatiki. Huonekana kwenye muhtasari kwenye mstari wake likisema tovuti ilielewa nini: “yamesomwa kama Matthew 26:39”, pamoja na kisanduku cha alama. Ondoa alama nalo huachwa nje; liache likiwa na alama nalo huenda pale mstari unaposema. Ikiwa kitabu hakitambuliki kabisa, mstari husema hivyo nalo dokezo huongezwa kama dokezo lisiloambatishwa badala yake — kamwe halilazimishwi kwenye kisio. Kitabu chenye namba huweka namba yake, kwa hiyo `1 Jonh` linaweza tu kusahihishwa kuwa 1 John, kamwe si 2 John.
Kile ambacho kwa makusudi haitafanya
Mfululizo wa mistari huambatisha dokezo kwenye mstari wake wa kwanza: `Matthew 26:39-41` huweka dokezo kwenye mstari wa 39, kwa sababu dokezo la JW Library huambatana na sehemu moja ya maandishi badala ya eneo pana. Rejeleo lenye sura lakini bila mstari — `Matthew 26` — huambatisha dokezo kwenye sura hiyo. Faili linalotaja chapisho badala ya andiko — `The Watchtower—2023 No. 4` — huletwa kama dokezo la kawaida lisiloambatishwa bila swali lolote kuulizwa, kwa kuwa hicho ndicho uhamishaji wa tovuti hii yenyewe huandika kwa madokezo yaliyoandikwa ndani ya makala.
Umbizo linalonusurika safari
Aya, mikato ya mstari, **nene**, *italiki* na orodha za vitone huingia kama umbizo halisi ndani ya JW Library. Kichwa kilicho juu ya faili hutumika kama kichwa cha dokezo badala ya kurudiwa ndani yake. Chochote ambacho Markdown inaweza kueleza lakini madokezo ya JW Library hayawezi — majedwali, picha, viungo, vizuizi vya msimbo — hupunguzwa hadi maandishi yake, kwa hiyo hakuna kinachopotea kutoka maneno hata pale mpangilio usipoweza kubebwa.
Madokezo huishia wapi hasa, na kwa nini hilo ni salama
Ili kuambatisha dokezo kwenye mstari, JW Library inahitaji vitambulisho vya ndani vya sura hiyo ambavyo ni mahususi kwa maktaba yako. JW Sync haivibuni kamwe. Hutumia tena mahali ambapo nakala yako rudufu tayari inapo kwa sura hiyo, au hunakili vitambulisho hivyo kutoka mahali pengine pa andiko ndani ya faili lilelile. Ikiwa nakala rudufu haina madokezo wala viangazio vyovyote vya Biblia, hakuna cha kunakili kutoka, kwa hiyo madokezo huongezwa kama madokezo yasiyoambatishwa badala ya kuambatishwa kwenye kitu ambacho programu huenda isikitambue. Hilo ni chaguo la makusudi: dokezo linalotua kimyakimya mahali pasipofaa ni baya kuliko lile linalofika wazi bila kuambatishwa.
Kuleta mafaili yaleyale mara mbili
Dokezo huchukuliwa kuwa tayari lipo wakati kichwa chake, maandishi yake na mahali pake vyote vinalingana na kitu kilicho ndani ya nakala rudufu, kwa hiyo kuleta tena uhamishaji uleule hakuongezi chochote mara mbili. Muhtasari hukuambia mangapi yalirukwa kwa sababu hiyo kabla hujathibitisha. Kila kitu ambacho uletaji huongeza ni hatua moja ya Kutendua, nayo madokezo yaliyoletwa huwekewa lebo ya Yaliyoletwa ili uweze kuyapata, kuyachuja au kuyafuta kama kundi baadaye.
Maswali yanayoulizwa mara kwa mara
- Je, lazima nitumie mistari ya ---?
- Hapana. Huifanya faili isiwe na utata, na kila kihariri cha Markdown huielewa, lakini unaweza pia kuanza faili moja kwa moja na sehemu — `title: …` kwenye mstari wa kwanza — au kuacha front matter kabisa na kuacha dokezo lichukue kichwa chake kutoka kichwa cha kwanza.
- Itakuwaje nikikosea tahajia ya jina la kitabu?
- Tovuti kwa kawaida itaelewa ulichokusudia, lakini haitatenda kutokana na hilo peke yake. Dokezo huonekana kwenye muhtasari likisema lilivyosomwa, pamoja na kisanduku cha alama, ili uthibitishe kabla ya chochote kuandikwa.
- Je, ninaweza kuleta folda nzima kutoka Obsidian?
- Chagua mafaili mengi ya .md upendavyo kwa mpigo mmoja, au ubane folda kisha uchague .zip. Mafaili yaliyo ndani ya kasha husomwa vilevile kama yaliyo huru.
- Je, kuleta kutaandika juu ya madokezo niliyo nayo tayari?
- Hapana. Kuleta huongeza tu. Madokezo, viangazio, alamisho na lebo zako zilizopo hazitaguswa, nalo faili ulilopakia halibadilishwi kamwe — unapakua .jwlibrary jipya mwishoni.
- Je, madokezo yangu hupakiwa popote?
- Hapana. Jambo lote hufanyika ndani ya kivinjari chako, kama kila kitu kingine kwenye tovuti hii. Nakala yako rudufu na mafaili yako ya Markdown hayaondoki kwenye kifaa chako kamwe.
- Ni lugha zipi ninazoweza kuandika rejeleo kwazo?
- Majina ya vitabu hutambuliwa kwa Kiingereza kwa sasa, ambacho pia ndicho uhamishaji huandika. Ikiwa unaandika madokezo yako kwa lugha nyingine, tumia sehemu za `book`, `chapter` na `verse` pamoja na jina la kitabu la Kiingereza, au ulete tu madokezo bila kuambatishwa kisha uyaweke kwa mkono baadaye.
- Je, ninaweza kuyatoa madokezo yangu tena?
- Ndiyo — Hamisha Markdown kwenye skrini ileile huandika kila dokezo kwenye faili la .md lenye sehemu zilezile, kwa hiyo madokezo yanaweza kusafiri kutoka JW Library na kurudi bila kupoteza mahali yanapohusika.