progit2-pt-br
progit2-pt-br copied to clipboard
progit
Links quebrados
Olá!
Identifiquei dois problemas recorrentes ao longo do livro:
- Links quebrados como este no último parágrafo da Seção 1.2:
- Aparecimento de colchetes após links, como este na Seção 1.5:
@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.
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.
Sem problemas, @rodrigomologni. Vou fazer nessa semana ainda. Obrigado.
@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.
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...
