Usar marcação USFM local (personalizada) do namespace \z no Paratext

Question

No nosso projeto, às vezes colocamos uma ou duas palavras da língua nacional (khmer) em uma nota de rodapé ou entrada de glossário, e queremos marcar isso para processamento pré-publicação. Definimos um marcador \zkh (usando o Namespace \z definido no USFM 3.0) e adicionamos o seguinte ao 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

Infelizmente, não vejo como usar isso no Paratext 9. Se estou na visão Standard (Padrão) e começo a digitar o marcador (digitando uma barra), um menu de contexto aparece e não me deixa digitar um “z”. Na verdade, ele me deixa digitar, mas se eu pressionar Enter, não acontece nada - ele não consegue encontrar o caminho para o texto.

Há alguma maneira de contornar isso?

Obrigado!

Tradução automática de English Mostrar original

Answer 1

viverechristus,

Quando você digita um marcador na janela, pode pressionar a barra de espaço para aceitar o marcador. Pressionar Enter só funciona se o marcador for um marcador válido para aquela lista. Por exemplo, se você pressionar \, ele mostra os estilos de caractere. Se você tentar digitar \p Enter, nada deve acontecer (ou ele lhe dará algo como \pn). Mas, se você pressionar \p Espaço, ele adicionará um marcador de parágrafo. No seu caso, se você pressionar \zkh Espaço, ele deve adicionar o marcador correto.

Observe que, se você destacar a(s) palavra(s) antes de pressionar \, ele deve adicionar os marcadores de abertura e fechamento ao redor da(s) palavra(s) selecionada(s).

Tradução automática de English Mostrar original

Comments

Obrigado. Eu deveria já saber disso, e fico feliz em saber agora.

Tradução automática de English Mostrar original

---

anon848905:

Pressionar Enter só funciona se o marcador for um marcador válido para aquela lista.

Obrigado por isso. É muito bom ouvir sobre essa nuance do PT. Mas estou pensando que não é muito intuitivo o PT tratar \marker< Enter > de forma diferente de \marker< Space >. (Programas SF antigos como Shoebox e Toolbox tratavam esses da mesma forma.)

A confusão de viverechristus indica que ele também achou estranho/frustrante que pressionar < Enter > não fizesse nada.

Então, há alguma vantagem para esse comportamento divergente que eu simplesmente não estou vendo?

Para mim, ou apenas < Space > deveria poder fechar o diálogo do marcador, e < Enter > nunca deveria fechá-lo, ou melhor, o PT deveria simplesmente tratar \marker< Enter > da mesma forma que \marker< Space > para fechar o diálogo e inserir o marcador SF. (A menos que haja um motivo muito bom para fazer essa distinção.)

Porque acho que usuários normais não vão se lembrar desse nível de distinção (se eles alguma vez souberam disso). Eles simplesmente assumem que estragaram algo quando ele não age como eles esperavam.

Tradução automática de English Mostrar original

---

Você está correto em que parece um pouco estranho. Aqui está o que eu entendo. Não importa qual seja o contexto ao adicionar um marcador, você sempre pode terminá-lo com o Espaço. Então, digitar \p Espaço adicionará um marcador de parágrafo. Este é, claro, o comportamento que você veria se estivesse na visão Unformatted (Sem formatação).

O problema com a tecla Enter é que, quando você está na visão Standard (Padrão) e está usando a ferramenta de seleção de marcador, a tecla Enter só funciona se o marcador estiver realmente presente na ferramenta naquele momento. Pressionar a tecla \ exibirá os estilos de caractere que estão atualmente disponíveis com base no usfm.sty e custom.sty (e frtbak.sty para outros livros). Então, se eu pressionar \ p, nunca verei apenas a opção \p. Vererei coisas como \pn. Se eu digitar \p e depois Enter, estarei na verdade selecionando um dos marcadores de caractere disponíveis. No entanto, devido à natureza do Espaço com marcadores, se eu pressionar um Espaço depois de digitar o p, eu realmente obtenho o marcador que quero.

Para marcadores de parágrafo, eu normalmente pressionaria Enter e depois digitaria o código do marcador. Então, se eu pressionar Enter p, verei a opção \p e, quando eu pressionar Enter novamente, obtive esse marcador.

Então, parte do problema é a diferença entre a exibição de estilos de parágrafo e de caractere e o que é visível dependendo se você começou com Enter ou Espaço.

Tradução automática de English Mostrar original

---

davidc78:

Para mim, ou apenas < Space > deveria poder fechar o diálogo do marcador, e < Enter > nunca deveria fechá-lo, ou melhor, o PT deveria simplesmente tratar \marker< Enter > da mesma forma que \marker< Space > para fechar o diálogo e inserir o marcador SF. (A menos que haja um motivo muito bom para fazer essa distinção.)

Só para ficar perfeitamente claro. Tanto Enter quanto Espaço encerram um marcador que está visivelmente presente na janela do marcador. Se um marcador não estiver presente na janela (quando você digita o marcador, não há nada visível na caixa abaixo), então pressionar Enter não fará nada. Pressionar Espaço adicionará esse marcador (mesmo se for um marcador inválido).

Tradução automática de English Mostrar original

---

Sim, isso ficou perfeitamente claro. Meu ponto é que não é intuitivo. Se temos que explicar algo com minúcias, é improvável que seja claro para um usuário normal. Não, não precisamos mudá-lo. Mas, se estamos procurando minimizar a confusão, então < Enter > nunca deveria não fazer nada. Porque, como está agora, < Enter > está agindo como ESC naquela situação – e isso é contra-intuitivo.

Tradução automática de English Mostrar original

---

Isso desbloqueou o mistério da seleção de livros da Bíblia a partir da lista suspensa da barra de ferramentas. Estou regularmente frustrado quando digito, digamos, “ru”, e tudo o que resta na lista é “RUT”, mas eu pressiono Enter e nada acontece. Vejo que, se eu pressionar espaço, obtenho RUT e a seleção do número do capítulo se torna ativa. Também noto que, quando Enter funciona, ele não me leva à seleção do capítulo, mas vai para o capítulo e versículo que já estão preenchidos.

A propósito, depois de pressionar Enter (e mover com sucesso para o livro que quero), o título do livro (abreviação) permanece destacado em azul, mesmo que o cursor agora esteja ativo no livro recém-selecionado (neste caso, Jonas 1:1):

Mais de uma vez, assumi que minha seleção falhou e tentei digitar o nome do livro novamente, apenas para descobrir que estou digitando bobagens em um versículo. Isso, para mim, é um potencial problema sério, porque pode levar a edições não intencionais e, muito ocasionalmente, não percebidas em versículos. O destaque em azul deveria significar apenas “pronto para seleção”, não “já selecionado”.

Tradução automática de English Mostrar original

---

ISSO.
Eu também frequentemente encontrei letras ou números falsos no primeiro versículo de livros porque o usuário pensava que estava digitando na caixa do livro ou capítulo, quando na verdade o cursor estava ativo no texto do versículo. Ufa.

Esse comportamento é confuso e perigoso, como viverechristus aponta. E, embora isso seja “delicado” e possa ser doloroso de corrigir no software, é perigoso o suficiente para que agora 2 pessoas tenham mencionado isso. Então, tenho certeza de que há outros também.

Tradução automática de English Mostrar original

---

Sim, já vi números extras adicionados por engano com bastante frequência.

Tradução automática de English Mostrar original

Answer 2

viverechristus:

Há alguma maneira de contornar isso?

Acho que o problema é que você não especificou um tipo para seu marcador personalizado. Se o tipo estiver ausente, o Paratext assume que é um estilo de parágrafo.
Tente adicionar a seguinte linha à definição do marcador no seu arquivo custom.sty:
\StyleType Character

Tradução automática de English Mostrar original

Comments

Obrigado. Especificar o StyleType fez com que o marcador fosse adicionado à ferramenta de seleção de contexto.

Tradução automática de English Mostrar original

---

A propósito, onde posso ir para ver a documentação sobre definições de folha de estilo válidas?

Tradução automática de English Mostrar original

---

Uma coisa a fazer é olhar (não editar) o arquivo usfm.sty para ver como os estilos são definidos. A outra coisa a olhar é o tópico de ajuda “Como implemento uma folha de estilo personalizada para meu projeto?”

Tradução automática de English Mostrar original

---

Obrigado, anon848905.

Tradução automática de English Mostrar original

Answer 3

Acabei de relatar isso como PTXS-23210. Se outros viram o problema, talvez vocês possam relatar também.

Tradução automática de English Mostrar original