Menggunakan markup USFM lokal (kustom) dari namespace \z di Paratext

Question

Dalam proyek kami, terkadang kami menyertakan satu atau dua kata dari bahasa nasional (Khmer) dalam catatan kaki atau entri glosarium, dan kami ingin menandai hal tersebut untuk pemrosesan pra-penerbitan. Kami telah mendefinisikan penanda \zkh (menggunakan namespace \z yang didefinisikan dalam USFM 3.0) dan menambahkan以下内容 ke custom.sty:

\Marker zkh
\Endmarker zkh*
\Name zkh...zkh* - Special Text - Khmer Language Text
\Description For Khmer Language text
\OccursUnder ip im ipi imi ipq imq ipr iq iq1 iq2 iq3 io io1 io2 io3 io4 ms ms1 ms2 s s1 s2 s3 s4 cd sp d lh li li1 li2 li3 li4 lf lim lim1 lim2 lim3 lim4 m mi nb p pc ph phi pi pi1 pi2 pi3 pr pmo pm pmc pmr po q q1 q2 q3 q4 qc qr qd qm qm1 qm2 qm3 tr th1 th2 th3 th4 thr1 thr2 thr3 thr4 tc1 tc2 tc3 tc4 tcr1 tcr2 tcr3 tcr4 f fe NEST

Sayangnya, saya tidak melihat cara untuk menggunakan ini di Paratext 9. Jika saya berada di tampilan Standard (Standar) dan mulai mengetik penandanya (dengan mengetik garis miring), menu konteks muncul, dan saya tidak bisa mengetik huruf “z”. Sebenarnya, saya bisa mengetiknya, tetapi jika saya menekan enter, tidak terjadi apa-apa - penanda tersebut tidak bisa masuk ke dalam teks.

Apakah ada cara untuk mengatasi ini?

Terima kasih!

Diterjemahkan secara otomatis dari English Tampilkan asli

Answer 1

viverechristus,

Quando Anda mengetik penanda di jendela, Anda dapat menekan spasi untuk menerima penanda tersebut. Menekan Enter hanya berfungsi jika penandanya adalah penanda yang valid untuk daftar tersebut. Misalnya, jika Anda menekan \, maka gaya karakter akan ditampilkan. Jika Anda mencoba mengetik \p lalu Enter, seharusnya tidak terjadi apa-apa (atau akan menghasilkan sesuatu seperti \pn). Tetapi jika Anda menekan \p lalu Spasi, maka penanda paragraf akan ditambahkan. Dalam kasus Anda, jika Anda menekan \zkh lalu Spasi, maka seharusnya penanda yang benar akan ditambahkan.

Perhatikan bahwa jika Anda menyorot kata-kata tersebut sebelum menekan \, maka seharusnya penanda pembuka dan penutup akan ditambahkan di sekitar kata-kata yang dipilih.

Diterjemahkan secara otomatis dari English Tampilkan asli

Comments

Terima kasih. Seharusnya saya sudah tahu ini sebelumnya, dan saya senang mengetahuinya sekarang.

Diterjemahkan secara otomatis dari English Tampilkan asli

---

anon848905:

Menekan Enter hanya berfungsi jika penandanya adalah penanda yang valid untuk daftar tersebut.

Terima kasih atas informasinya. Sangat menyenangkan mendengar tentang nuansa PT ini. Tetapi saya berpikir bahwa tidak sangat intuitif jika PT memperlakukan \marker< Enter > berbeda dengan \marker< Space >. (Program-program SF lama seperti Shoebox dan Toolbox memperlakukan keduanya sama.)

Kebingungan viverechristus menunjukkan bahwa dia juga merasa aneh/menyesalkan bahwa menekan < Enter > tidak menghasilkan apa-apa.

Jadi, apakah ada keuntungan dari perilaku yang berbeda ini yang tidak saya lihat?

Bagi saya, sebaiknya hanya < Space > yang bisa menutup dialog penanda, dan < Enter > tidak pernah boleh menutupnya, atau lebih baik lagi, PT sebaiknya memperlakukan \marker< Enter > sama dengan \marker< Space > untuk menutup dialog dan memasukkan penanda SF. (Kecuali ada alasan yang sangat baik untuk membuat pembedaan ini.)

Karena saya merasa pengguna biasa tidak akan mengingat pembedaan tingkat ini (jika mereka pernah mengetahuinya). Mereka hanya mengasumsikan mereka salah melakukan sesuatu ketika program tidak berperilaku seperti yang mereka harapkan.

Diterjemahkan secara otomatis dari English Tampilkan asli

---

Anda benar bahwa hal ini tampak sedikit aneh. Berikut yang saya pahami. Tidak peduli apa konteks dalam menambahkan penanda, Anda selalu bisa mengakhiri dengan Spasi. Jadi mengetik \p lalu Spasi akan menambahkan penanda paragraf. Tentu saja, ini adalah perilaku yang akan Anda lihat jika Anda berada di tampilan Unformatted (Tidak Terformat).

Isu dengan tombol Enter adalah bahwa ketika Anda berada di tampilan Standard (Standar) dan menggunakan alat pemilihan penanda, tombol Enter hanya berfungsi jika penandanya benar-benar ada di alat tersebut pada saat itu. Menekan tombol \ akan menampilkan gaya karakter yang saat ini tersedia berdasarkan usfm.sty dan custom.sty (dan frtbak.sty untuk buku-buku lain). Jadi jika saya menekan \ p, saya tidak akan pernah melihat hanya opsi \p. Saya akan melihat hal-hal seperti \pn. Jika saya mengetik \p lalu Enter, saya sebenarnya akan memilih salah satu penanda karakter yang tersedia. Namun, karena sifat Spasi dengan penanda, jika saya menekan Spasi setelah mengetik p, saya sebenarnya mendapatkan penanda yang saya inginkan.

Untuk penanda paragraf, saya biasanya menekan Enter lalu mengetik kode penandanya. Jadi jika saya menekan Enter lalu p, saya akan melihat opsi \p dan ketika saya menekan Enter lagi, saya mendapatkan penanda tersebut.

Jadi, sebagian dari masalahnya adalah perbedaan antara tampilan gaya paragraf dan karakter, dan apa yang terlihat tergantung pada apakah Anda memulai dengan Enter atau Spasi.

Diterjemahkan secara otomatis dari English Tampilkan asli

---

davidc78:

Bagi saya, sebaiknya hanya < Space > yang bisa menutup dialog penanda, dan < Enter > tidak pernah boleh menutupnya, atau lebih baik lagi, PT sebaiknya memperlakukan \marker< Enter > sama dengan \marker< Space > untuk menutup dialog dan memasukkan penanda SF. (Kecuali ada alasan yang sangat baik untuk membuat pembedaan ini.)

Hanya untuk menjadi sangat jelas. Baik Enter maupun Spasi akan mengakhiri penanda yang terlihat ada di jendela penanda. Jika penanda tidak ada di jendela (ketika Anda mengetik penandanya, tidak ada yang terlihat di kotak di bawahnya), maka menekan Enter tidak akan melakukan apa-apa. Menekan Spasi akan menambahkan penanda tersebut (bahkan jika itu adalah penanda yang tidak valid).

Diterjemahkan secara otomatis dari English Tampilkan asli

---

Ya, itu sangat jelas. Poin saya adalah hal itu tidak intuitif. Jika kita harus menjelaskan sesuatu dengan detail yang sangat rinci, maka kemungkinan besar hal itu tidak akan pernah jelas bagi pengguna biasa. Tidak, kita tidak harus mengubahnya. Tetapi jika kita ingin meminimalkan kebingungan, maka < Enter > tidak pernah boleh tidak melakukan apa-apa. Karena seperti sekarang, < Enter > berperilaku seperti ESC dalam situasi tersebut – dan itu tidak intuitif.

Diterjemahkan secara otomatis dari English Tampilkan asli

---

Hal ini telah membuka misteri tentang pemilihan buku Alkitab dari drop-down toolbar. Saya sering frustrasi ketika saya mengetik, misalnya, “ru”, dan yang tersisa di daftar hanyalah “RUT”, tetapi saya menekan enter dan tidak terjadi apa-apa. Saya melihat bahwa jika saya menekan spasi, saya mendapatkan RUT dan pemilihan nomor ayat menjadi aktif. Saya juga memperhatikan bahwa ketika enter berfungsi, itu tidak memindahkan saya ke pemilihan ayat, tetapi justru pergi ke ayat dan pasal yang sudah terisi.

Secara kebetulan, setelah menekan enter (dan berhasil pindah ke buku yang saya inginkan), judul buku (singkatan) tetap disorot biru, meskipun kursor sekarang aktif di buku yang baru dipilih (dalam hal ini, Yunus 1:1):

Lebih dari sekali saya mengasumsikan bahwa pemilihan saya gagal, dan saya mencoba mengetik nama buku lagi, hanya untuk menemukan bahwa saya sedang mengetik hal-hal yang tidak masuk akal ke dalam ayat. Bagi saya, ini adalah masalah yang berpotensi serius karena dapat menyebabkan pengeditan yang tidak disengaja dan sangat jarang disadari di dalam ayat. Sorotan biru seharusnya hanya berarti “siap untuk dipilih”, bukan “sudah dipilih”.

Diterjemahkan secara otomatis dari English Tampilkan asli

---

ININYA.
Saya juga sering menemukan huruf atau angka palsu di ayat pertama buku-buku karena pengguna berpikir mereka sedang mengetik di kotak buku atau pasal, padahal kursor aktif di teks ayat. Waduh.

Perilaku ini membingungkan dan berbahaya seperti yang ditunjukkan oleh viverechristus. Dan meskipun ini “hal kecil” dan mungkin menyakitkan untuk diperbaiki di perangkat lunak, ini cukup berbahaya sehingga sekarang 2 orang telah menyebutkannya. Jadi saya yakin ada orang lain juga.

Diterjemahkan secara otomatis dari English Tampilkan asli

---

Ya, saya sering melihat angka tambahan yang ditambahkan secara tidak sengaja.

Diterjemahkan secara otomatis dari English Tampilkan asli

Answer 2

viverechristus:

Apakah ada cara untuk mengatasi ini?

Saya rasa masalahnya adalah Anda tidak menentukan tipe untuk penanda kustom Anda. Jika tipe tidak ada, Paratext mengasumsikannya sebagai gaya paragraf.
Coba tambahkan baris berikut ke definisi penanda Anda di file custom.sty:
\StyleType Character

Diterjemahkan secara otomatis dari English Tampilkan asli

Comments

Terima kasih. Menentukan StyleType membuat penanda tersebut ditambahkan ke alat pemilihan konteks.

Diterjemahkan secara otomatis dari English Tampilkan asli

---

Btw, di mana saya bisa melihat dokumentasi tentang definisi stylesheet yang valid?

Diterjemahkan secara otomatis dari English Tampilkan asli

---

Satu hal yang bisa dilakukan adalah melihat (jangan diedit) file usfm.sty untuk melihat bagaimana gaya didefinisikan. Hal lain yang perlu dilihat adalah topik bantuan “Bagaimana saya menerapkan stylesheet kustom untuk proyek saya?”

Diterjemahkan secara otomatis dari English Tampilkan asli

---

Terima kasih, anon848905.

Diterjemahkan secara otomatis dari English Tampilkan asli

Answer 3

Saya baru saja melaporkan ini sebagai PTXS-23210. Jika orang lain telah melihat masalahnya, mungkin Anda juga bisa melaporkannya.

Diterjemahkan secara otomatis dari English Tampilkan asli