Tags e ícones de notas foram perdidos durante a criação de um novo projeto [resolvido]

Question

Eu não marquei esta publicação como uma “pergunta”. Pode ser um relatório de bug, a menos que eu descubra que fizemos algo errado. [edição e spoiler: NÃO era um bug; nós ignoramos um recurso; leia toda a thread para saber tudo; isso agora está marcado como uma “pergunta” e o título está marcado como “resolvido”; tudo está bem]

Recentemente, um projeto foi ramificado (forked): um local “Backup project to file” e depois um local “Restore project from file” com a opção “New Project”. Todos os arquivos foram selecionados no processo de criação do novo projeto, conforme proposto pelo PT, incluindo o que estava listado como “Note Tags [data e hora]”. O novo projeto está devidamente registrado e funciona bem até agora.

Mas hoje a equipe notou* que todas as notas especiais não estão mais marcadas como antes. No projeto, as tags especiais desapareceram. As notas em si estão bem. Mas todas aquelas que tinham tags e ícones especiais estão mostrando um espaço em branco (na janela Notes List) onde normalmente o ícone estaria.

Fiz algumas investigações:
Atualmente, temos um novo arquivo CommentTags.xml que está quase vazio. Parece que o PT não o encontrou após o fork e criou um novo em branco com apenas a bandeira vermelha padrão. (O projeto está atualmente usando o PT 9.3.103.7.)

Ainda temos acesso ao arquivo anterior CommentTags.xml com nossas tags e ícones especiais. (Este é de uma versão do PT9 que era “a mais recente” em torno do outono de 2022.)

Encontrei esta pergunta relacionada (sobre o PT7)

Import note tags Questions

Hi, I was wondering if there is a straightforward way to import a set of note tags into a project? For example, if a consultant has a basic set of note tags that he would like to use on all the projects he checks, is there a simple way to import them, or does he need to recreate them in all the projects? I have experimented (In Paratext 7) with copying the CommentTags.xml file into a project directory, and then opening the note tags in Project properties, and it seemed to work, but I wasn’t su…

onde o usuário está sendo encorajado com " Copying the CommentTags.xml file should not cause any issues."

Como agora estamos no PT9, versão mais recente, quero pedir um encorajamento semelhante, antes de fazer o processo de enxerto ou emenda. Posso substituir o novo arquivo incompleto pelo antigo e completo CommentsTags.xml?

Fiz uma comparação de arquivos nos dois arquivos XML e encontrei que as estruturas são totalmente semelhantes. Apenas o arquivo antigo tem mais entradas. Eu arriscaria.

Obrigado por seus pensamentos.

TL/DR:

Nota sobre um possível plano B: Eu sei como criar manualmente novas tags e selecionar ícones na aba “notes” das propriedades do projeto. Eu conheço os Nomes e os Ícones e os Modelos de nossas notas sobre notas. Eu apenas temo que diferentes Tag-IDs possam ser atribuídos, se eu recriar o antigo sistema pela GUI do PT. Existem certos IDs ausentes no arquivo XML antigo, o que me diz que a equipe deve ter excluído certas tags no passado. Então, considerei isso, como possivelmente “mais seguro” do que hackear arquivos XML. Mas como os IDs não são acessíveis pela GUI, eu não gosto muito deste plano B.

*Hoje tivemos uma ocasião em que o usuário X enviou algumas notas para o usuário Y, como no passado, solicitando que um lote inteiro de edições fosse inserido no projeto principal do PT, incluindo mudanças de ortografia para certos termos-chave. Este foi o momento em que a equipe descobriu que suas tags e ícones especiais haviam desaparecido.

O usuário X é muito qualificado para observações linguísticas e para discutir tais questões com a equipe. Então, tais edições fundamentais no PT são sempre tratadas pelo membro da equipe Y, que tem uma boa noção do PT e de como inserir que tipo de mudanças; especialmente se elas concernem a mais de um versículo.

Havia uma tag e um ícone especiais para esse tipo de trabalho, entre o usuário X e o usuário Y.

Essas tags e ícones (cerca de 10) são importantes para a equipe e o projeto; eles fazem parte do fluxo de trabalho e realmente ajudam a não afundar em bandeiras vermelhas. Há muitas notas no total, então é importante que eles possam filtrar e saber o que é o quê.

Tradução automática de English Mostrar original

Answer 1

Feche o Paratext antes de fazer qualquer alteração nos arquivos na pasta do projeto do Paratext!
Você pode copiar com segurança o antigo CommentsTags.xml para o novo projeto. Se você estiver preocupado, eu sugeriria que, na pasta do novo projeto, você altere o arquivo original para algo como CommentTags.old. Dessa forma, você sempre pode alterar a extensão e voltar ao estado anterior.
Aqui está um vídeo rápido sobre o processo para garantir que você obtenha as tags de notas ao restaurar um projeto:

NOTA quando eu fiz a restauração, também selecionei as “Settings” e isso pode alterar configurações que acabaram de ser adicionadas ao projeto.

Observe que a melhor maneira de “ramificar” (fork) um projeto PT8 ou PT9 é usar a ferramenta Project Settings > Advanced > Convert Project. Isso mantém todo o histórico e outras informações no projeto. Se você tiver muito histórico, esse processo pode levar muito tempo.
Se o projeto vier do PT7, você precisará usar o processo de Backup/Restore que está usando e perderá o histórico.

Tradução automática de English Mostrar original

Answer 2

Muito obrigado @anon848905. Eu acabei de fazer a correção e funcionou.

Levará alguns send-receive de vários computadores da equipe para ver se temos algum efeito colateral. Não estou preocupado com esses poucos. (Lembre-se, o problema foi descoberto durante um lote completo de trabalho real.)

Eu suspeito, com alguns experimentos desta manhã (onde eu havia criado uma nova tag para teste), que podemos ter algumas notas “engraçadas” que foram inseridas como today-ID2 e agora aparecerão como a nova ID2, que é realmente a boa e velha ID2 de antes do fork.

Eu havia feito um backup local do projeto do PT.
Eu havia criado um marco (milestone).
Eu havia fechado o PT.

Tradução automática de English Mostrar original

Answer 3

Resposta separada sobre a causa do problema:

Estou grato ao @anon848905 por ter se dado ao trabalho de criar um vídeo. Para meu próprio benefício, adicionarei em palavras como nosso problema aconteceu:

A partir de 1:31 no vídeo, é visível como o procedimento se parece em detalhes: Ao “restaurar projeto de arquivo” com a opção “novo projeto”, o PT9 propõe não usar as antigas “Note Tags”, mas propõe criar um conjunto novo.

Eu não estou criticando o PT por esse recurso, os desenvolvedores devem ter tido razões para operar o procedimento dessa forma. Talvez uma nota na coluna de ajuda à direita orientasse os usuários sobre essa questão. (Ramificar um projeto ou mudar uma ONG é tão raro que ninguém pode aprender e reter tais detalhes, mesmo que tenham sido mencionados uma vez durante algum treinamento.)

Como usuário e apoiador do projeto, eu não teria anulado uma proposta do PT durante o processo estressante de fazer um fork.

Até esta manhã, eu nunca soube do arquivo chamado CommentTags.xml, embora o projeto em questão faça bom uso do seu próprio conjunto personalizado de tags e ícones. Novamente, como escrevi em outro lugar, eu amo a forma como o PT é escrito de maneira modular e com arquivos XML legíveis.

Duvido que haverá outro fork nos próximos 20 anos, mas talvez isso possa ajudar outras equipes. Ou nos servirá no futuro, quando encontrarmos pequenos abalos e quisermos verificar o que aconteceu em março de 2023 com as notas.

Editarei o primeiro parágrafo da minha pergunta, esclarecerei que isso não é sobre um bug e marcarei minha pergunta como resolvida.

Também agradeço ao @anon848905 pela informação bônus não solicitada de que há uma maneira melhor de fazer forks de projeto.

Tradução automática de English Mostrar original