Links quebrados

[rodrigomologni]

Olá!

Identifiquei dois problemas recorrentes ao longo do livro:

1. Links quebrados como este no último parágrafo da Seção 1.2:

2. Aparecimento de colchetes após links, como este na Seção 1.5:

[sergiocabral]

@rodrigomologni, beleza?

Sobre esses links quebrados, você está sugerindo que alguém possa fazer a correção? Ou está se prontificando a fazê-la?

Pergunto isso porque o projeto deste manual é aberto para colaboração e muitas gente faz as correções necessárias que encontram pelo livro.

[rodrigomologni]

Oi, @sergiocabral! Sim, eu sei que a colaboração é aberta. Mas como eu não soube corrigir, então optei apenas por reportar o erro. Assim um contribuidor poderia corrigir.

[sergiocabral]

Sem problemas, @rodrigomologni. Vou fazer nessa semana ainda. Obrigado.

[rodrigomologni]

Obrigado você, @sergiocabral!

[sergiocabral]

@rodrigomologni mencionei você lá no PR da correção. Porém foi uma correção parcial.

O primeiro link quebrado que falou tem relação com alguma configuração do projeto. Já o segundo era uma correção no texto da tradução.

Quando eu entender como finalizar a correção pendente te deixo informado.

Mais uma vez obrigado.

[rodrigomologni]

Legal, @sergiocabral! Obrigado você!

[git-em]

Estava investigando sobre essa questão dos links... Pelo que vi, tem vários que não estão funcionando corretamente -- com um comportamento similar ao desse da Seção 1.2.

Se entendi bem, o problema é como as tags* foram colocadas nos arquivos. O padrão que estaria funcionando atualmente no progit2-br é usando r_git_branching pra se referir ao que na Seção 1.2 se usa ch03-git-branching.

Checando o arquivo ch03-git-branching.asc no progit2-br, dá pra ver que se utilizam duas tags distintas, [#ch03-git-branching] e [[r_git_branching]]. Já no arquivo referente à Seção 1.2, como mencionei acima, o link é feito com <<ch03-git-branching#ch03-git-branching>>, da mesma forma com que é feito no arquivo da Seção 1.2 do repositório oficial em inglês.

A diferença é que na build do repositório original a referência funciona...

Checando, então o arquivo ch03-git-branching.asc no repositório oficial, vê-se que a tag utilizada é justamente [[ch03-git-branching]]!

Sendo assim, acho que um jeito de corrigir esses links quebrados seria fazendo referência aos links da "maneira antiga", no caso, acho que seria <<ch03-git-branching#r_git_branching>>.

Porém, acho que faria mais sentido atualizar essas tags pro modelo que está sendo atualmente utilizado no projeto original. Nesse caso, a modificação deveria ser feita no arquivo ch03-git-branching.asc.
Eu só não sei se essa segunda opção vai acabar quebrando as nossas builds de algum outro jeito...

*Acho que o que o termo correto pro que estou chamando de tags é macro, mas não tenho certeza...

[sergiocabral]

Obrigado, @rodrigomologni, pelo relato inicial, e @git-em pela investigação das referências internas. A nova base incorporada pelo PR #138 alinha as âncoras à estrutura inglesa; o caso citado foi corrigido e a release 2.1.49 foi gerada com sucesso. Vou encerrar como resolvida, mas um caso específico que reapareça no site pode ser registrado novamente.

[sergiocabral]

@rodrigomologni e @git-em, o livro completo em pt-BR foi finalizado no PR #145. Continuaremos atentos a referências e links quebrados durante a revisão textual; quando o defeito também existir no inglês, a correção deve partir da fonte canônica.