Olá novamente,
Estou voltando a este tópico para perguntar sobre a melhor prática para lidar com estes e outros erros relacionados a marcadores que surgem quando basic checks. Como sua validade é definida nos arquivos .sty, isso me faz pensar que configurações precisam ser feitas lá para resolver os erros, mas não quero mexer por baixo do capô se há algo que eu deveria estar mudando em outro lugar.
Eu tinha estado ignorando/negando erros de marcadores por um tempo, mas agora estou preparando um livro para envio ao DBL e parece que esses erros devem ser resolvidos de forma mais adequada. Há três erros gerais com marcadores que não consigo resolver:
- \xt não permitido em parágrafos de Introdução (\ip);
- \ior não permitido em parágrafos de Sumário da Introdução (\io#); e
- marcadores incorporados sendo relatados como ‘desconhecidos’ (ex.: um link de glossário incorporado dentro de palavras de Jesus com um marcador \+w).
As informações da folha de estilo na aba Avançado das Propriedades do Projeto indicam que está usando a Folha de Estilo usfm.sty, observando que está “Personalizada”. Mudei a versão do USFM para 3, mas não houve mudança nos resultados das Basic Checks. Quando olho no usfm.sty na pasta “C:\My Paratext 9 Projects”, mostra “Version=3.0.2”. Como as Propriedades do Projeto relatam que usa uma Folha de Estilo “Personalizada”, também olhei o arquivo custom.sty na minha pasta do projeto. Os comentários no topo desse arquivo dizem que ele “foi criado pela atualização para o Paratext 8.0. Ele é baseado nos arquivos de estilo originais usados pelo seu projeto. Esses arquivos foram removidos, mas um backup dos arquivos foi salvo em usfm-color.sty.bak e custom.sty.bak” Eu não vejo nenhum desses arquivos .bak na minha pasta de projeto atual, mas presumo que eles devem ter estado na pasta do Paratext 8.
Eu renomeei temporariamente o custom.sty na minha pasta do projeto (ou seja, para que a aba Avançado não relatasse mais uma folha de estilo “Personalizada” quando reiniciei o Paratext). Eu não tinha mais o mesmo estilo de cores personalizado a que estávamos acostumados, mas quando executei as basic checks com essa configuração, os erros com \xt e o \ior foram resolvidos. O marcador +w ainda foi relatado como um “Marcador desconhecido”, no entanto.
Então, dei uma olhada nas definições de \Marker no arquivo custom.sty na minha pasta de projeto atual e vi algumas pistas para resolver os erros de Marcador:
- Para a regra “\Marker xt”, meu custom.sty atual tem apenas o valor “x” para sua propriedade “\Occurs under”, enquanto no arquivo usfm.sty eu encontro uma lista bastante longa de marcadores permitidos.
- Para a regra “\Marker ior”, meu custom.sty atual tem apenas o valor “id” para sua propriedade “\Occurs under”, enquanto no arquivo usfm.sty eu o encontro permitido para ocorrer sob os vários Sumários da Introdução, bem como o valor “NEST”.
- Para a regra “\Marker w”, meu custom.sty atual tem um subconjunto dos valores que ocorrem no arquivo usfm.sty, bem como falta o valor “NEST”.
Então, fiz outras cópias temporárias do arquivo custom.sty; uma na qual usei todos os valores “\Occurs under” do usfm.sty para esses três marcadores, e outra na qual eu apenas comentei a informação para esses marcadores no arquivo custom.sty. Como esperado, eu recuperei meu estilo de cores personalizado, mas os resultados das Basic Checks foram os mesmos de quando eu tinha removido o custom.sty: os erros com \xt e o \ior foram resolvidos, mas o marcador \+w ainda foi relatado como um “Marcador desconhecido”.
Há alguma maneira de resolver os erros de “Marcador desconhecido” para marcadores \+w? E editar meu arquivo custom.sty como descrito acima é a melhor maneira de resolver os erros de “Não pode ocorrer aqui” para marcadores \xt e \ior na Introdução?
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?
Tradução automática de English