Skip to content

Links quebrados #52

Closed
Closed

Description

@rodrigomologni

Olá!

Identifiquei dois problemas recorrentes ao longo do livro:

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

image

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

image

Activity

  1. sergiocabral commented on May 25, 2021

    @sergiocabral
    Collaborator

    @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.

  2. rodrigomologni commented on May 25, 2021

    @rodrigomologni
    Author

    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.

  3. sergiocabral commented on May 25, 2021

    @sergiocabral
    Collaborator

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

  4. rodrigomologni commented on May 25, 2021

    @rodrigomologni
    Author

    Obrigado você, @sergiocabral!

  5. sergiocabral commented on May 26, 2021

    @sergiocabral
    Collaborator

    @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.

  6. rodrigomologni commented on May 26, 2021

    @rodrigomologni
    Author

    Legal, @sergiocabral! Obrigado você!

  7. git-em commented on Nov 3, 2021

    @git-em
    Contributor

    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...

  8. sergiocabral commented on Aug 20, 2026

    @sergiocabral
    Collaborator

    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.

  9. sergiocabral commented on Aug 20, 2026

    @sergiocabral
    Collaborator

    @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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions