Halo lagi,
Saya kembali ke utas ini untuk bertanya tentang praktik terbaik dalam menangani ini dan kesalahan terkait penanda lainnya yang muncul saat pemeriksaan dasar (basic checks). Karena validitasnya didefinisikan di file .sty, saya berpikir bahwa konfigurasi perlu dilakukan di sana untuk menyelesaikan kesalahan, tetapi saya tidak ingin mengutak-atik bagian internal jika ada sesuatu yang harus saya ubah di tempat lain.
Saya telah mengabaikan/menolak kesalahan penanda selama beberapa waktu, tetapi sekarang saya sedang mempersiapkan sebuah kitab untuk diserahkan ke DBL dan sepertinya kesalahan ini harus diselesaikan dengan lebih tepat. Ada tiga kesalahan umum dengan penanda yang tidak dapat saya selesaikan:
- \xt tidak diizinkan dalam paragraf Pengantar (\ip);
- \ior tidak diizinkan dalam paragraf Garis Besar Pengantar (\io#); dan
- penanda tertanam dilaporkan sebagai ‘tidak diketahui’ (misalnya tautan glosarium yang tertanam di dalam perkataan Yesus dengan penanda \+w).
Informasi lembar gaya di tab Lanjutan (Advanced) dari Properti Proyek menunjukkan bahwa ia menggunakan Lembar Gaya usfm.sty, dengan catatan bahwa itu “Dikustomisasi”. Saya mengubah versi USFM menjadi 3, tetapi tidak ada perubahan dalam hasil Pemeriksaan Dasar (Basic Checks). Ketika saya melihat di usfm.sty di folder “C:\My Paratext 9 Projects”, itu menunjukkan “Version=3.0.2”. Karena Properti Proyek melaporkan bahwa ia menggunakan Lembar Gaya “Dikustomisasi”, saya juga melihat file custom.sty di folder proyek saya. Komentar di bagian atas file itu mengatakan bahwa itu “dibuat oleh peningkatan ke Paratext 8.0. Ini didasarkan pada file gaya asli yang digunakan oleh proyek Anda. File-file ini telah dihapus, tetapi cadangan file telah disimpan ke usfm-color.sty.bak dan custom.sty.bak” Saya tidak melihat file .bak tersebut di folder proyek saya saat ini, tetapi saya asumsikan mereka pasti ada di folder Paratext 8.
Saya secara sementara mengubah nama custom.sty di folder proyek saya (yaitu sehingga tab Lanjutan tidak lagi melaporkan lembar gaya “Dikustomisasi” ketika saya memulai ulang Paratext). Saya tidak lagi memiliki penataan warna kustom yang biasa kami gunakan, tetapi ketika saya menjalankan pemeriksaan dasar dengan pengaturan itu, kesalahan dengan \xt dan \ior terselesaikan. Penanda +w masih dilaporkan sebagai “Penanda Tidak Diketahui”, meskipun.
Jadi saya melihat melalui definisi \Marker di file custom.sty di folder proyek saya saat ini, dan melihat beberapa petunjuk untuk menyelesaikan kesalahan Penanda:
- Untuk aturan “\Marker xt”, custom.sty saya saat ini hanya memiliki nilai “x” untuk propertinya “\Occurs under”, sementara di file usfm.sty saya menemukan daftar penanda yang diizinkan yang cukup panjang.
- Untuk aturan “\Marker ior”, custom.sty saya saat ini hanya memiliki nilai “id” untuk propertinya “\Occurs under”, sementara di file usfm.sty saya menemukan bahwa ia diizinkan untuk terjadi di bawah berbagai Garis Besar Pengantar, serta nilai “NEST”.
- Untuk aturan “\Marker w”, custom.sty saya saat ini memiliki subset dari nilai-nilai yang terjadi di file usfm.sty, serta tidak memiliki nilai “NEST”.
Jadi saya membuat salinan sementara lainnya dari file custom.sty; satu di mana saya menggunakan semua nilai “\Occurs under” dari usfm.sty untuk ketiga penanda ini, dan satu lagi di mana saya hanya mengomentari informasi untuk penanda-penanda ini di file custom.sty. Seperti yang diharapkan, saya mendapatkan kembali penataan warna kustom saya, tetapi hasil Pemeriksaan Dasar sama dengan ketika saya menghapus custom.sty: kesalahan dengan \xt dan \ior terselesaikan, tetapi penanda \+w masih dilaporkan sebagai “Penanda Tidak Diketahui”.
Apakah ada cara untuk menyelesaikan kesalahan “Penanda Tidak Diketahui” untuk penanda \+w? Dan apakah mengedit file custom.sty saya seperti yang saya jelaskan di atas adalah cara terbaik untuk menyelesaikan kesalahan “Tidak dapat terjadi di sini” untuk penanda \xt dan \ior di Pengantar?
Hi again,
I’m returning to this thread to ask about the best practice for handling these and other marker-related errors that come up when basic checks. Since their validity is defined in the .sty files, it makes me think that configurations need to be done there to resolve errors, but I don’t want to mess around under the hood if there is something I should be changing somewhere else instead.
I had been ignoring/denying marker errors for a while, but now I’m getting a book ready for submission to the DBL and it seems like these errors should be resolved more properly. There are three general errors with markers that I can’t resolve:
- \xt not allowed in Introduction paragraphs (\ip);
- \ior not allowed in Introduction Outline paragraphs (\io#); and
- embedded markers being reported as ‘unknown’ (eg. a glossary link embedded within words of Jesus with a \+w marker).
The stylesheet info in the Advanced tab of Project Properties indicates that it is using the usfm.sty Stylesheet, noting that it is “Customized”. I changed the USFM version to 3, but there was no change in the results of the Basic Checks. When I look in usfm.sty in the “C:\My Paratext 9 Projects” folder, it shows “Version=3.0.2”. Since the Project Properties reports that it uses a “Customized” Stylesheet, I looked at the custom.sty file in my project folder as well. The comments at the top of that file say that it “was created by the upgrade to Paratext 8.0. It is based upon the original style files used by your project. These files have been removed, but a backup of the files has been saved to usfm-color.sty.bak and custom.sty.bak” I don’t see either of those .bak files in my current project folder, but I assume they must have been in the Paratext 8 folder.
I temporarily renamed custom.sty in my project folder (ie so the Advanced tab no longer reported a “Customized” stylesheet when I restarted Paratext). I no longer had the same custom color styling we were used to, but when I ran the basic checks with that setup, the errors with \xt and the \ior were resolved. The +w maker was still reported as an “Unknown marker”, though.
So I took a look through the \Marker definitions in the custom.sty fie in my current project folder, and saw some clues to resolving the Marker errors:
- For the “\Marker xt” rule, my current custom.sty has only the value “x” for its “\Occurs under” property, while in the usfm.sty file I find quite a long list of permissible markers.
- For the “\Marker ior” rule, my current custom.sty has only the value “id” for its “\Occurs under” property, while in the usfm.sty file I find it allowed to occur under the various Introduction Outline, as well as the “NEST” value.
- For the “\Marker w” rule, my current custom.sty has a subset of the values that occur in the usfm.sty file, as well as missing the “NEST” value.
So I made other temporary copies of the custom.sty file; one in which I used all the “\Occurs under” values from the usfm.sty for these three markers, and another in which I just commented-out the informaton for these arkers in the custom.sty file. As expected, I did get my custom color styling back, but the results of the Basic Checks was the same as when I had removed custom.sty: the errors with \xt and the \ior were resolved, but \+w maker was still reported as an “Unknown marker”.
Is there any way to resolve the “Unknown marker” errors for \+w markers? And is editing my custom.sty file as I described above the best way to resolve the “Cannot occur here” errors for \xt and \ior markers in the Introduction?
Diterjemahkan secara otomatis dari English