Navegador de ajuda do Yelp e o catálogo do scrollkeeper

Question

Eu preciso de ajuda para entender como funciona o Navegador de Ajuda do Yelp. Quando eu inicio o Yelp no Ubuntu 17.10 eu recebo o Guia do Ubuntu Desktop, e quando eu procuro termos que definitivamente devem estar contidos em alguns dos pacotes de documentação que eu instalei recentemente, eu entro em branco.

Meu entendimento (com base em esta página no gnome.org) é que o Yelp usa o catálogo do scrollkeeper para gerar uma tabela de conteúdo, mas parece que esse comportamento é substituído na distribuição do Ubuntu. Além disso, a versão do Ubuntu não tem os menus (permitindo bookmarking, etc.) exibidos na captura de tela nessa página. Ao instalar os pacotes de documentação recebi feedback no terminal de que o pacote estava registrado com o scrollkeeper. Vou continuar procurando uma resposta, mas se você pudesse ajudar, seria muito apreciado.

    

Answer 1

Eu tinha baixado o código-fonte do Yelp 3.26 moderno (fornecido com 18.04 LTS) e grep -ed para ocorrências de scrollkeeper:

apt-get source yelp
cd yelp-3.26.0

O grepping não obtém resultados no código, apenas em arquivos de texto

$ grep -ir scroll.*keeper . | awk '{print $1}' | sort | uniq 
./ChangeLog:
./debian/changelog:
./NEWS:

Um dos resultados do Changelog diz:

% bl0ck_qu0te%

Mas eles não usam nem mesmo rarian no código do aplicativo:

$ grep -ir rarian .
./ChangeLog:    Port to Rarian 0.8 series
./ChangeLog:    - Switch to using rarian instead of scrollkeeper
./ChangeLog:    Convert search across to use Rarian
./ChangeLog:    Now Rarian is fast, don't split out man and info pages.
./ChangeLog:    Spoon is now Rarian.  Bump min version to 0.5.0
./NEWS:* Port to Rarian 0.8 series
./NEWS:  - Remove scrollkeeper in favour of Rarian
./debian/changelog:      - Build depend on librarian-dev (>= 0.7.0).
./debian/changelog:    + added build-depends on librarian-dev.

Portanto, a pesquisa de texto completo não está disponível no Yelp devido à remoção dos indexadores ScrollKeeper e Rarian.

Notas:

1. algum patch existe no antigo bugzilla GNOME # 652057 e GitLab moderno . Mas não é aplicado no branch master.

2. se você estiver usando o Ubuntu 16.04 LTS, você pode instalar dependências de compilação, baixar e aplicar este patch:

   # software-properties-gtk # enable Source code repositories
   sudo apt-get build-dep yelp
   sudo apt-get install devscripts
   
   cd ~/Downloads
   wget https://gitlab.gnome.org/GNOME/yelp/uploads/b51ee8a2dc22f423f06e0293476328e5/xref-handling-and-indexing-for-help-list.patch
   
   mv xref-handling-and-indexing-for-help-list.patch yelp-3.18.1/debian/patches
   cd yelp-3.18.1
   echo "xref-handling-and-indexing-for-help-list.patch" >> debian/patches/series
   debuild -uc -us
   sudo dpkg -i ../*yelp*.deb
   

   Após a instalação, você pode testar a versão corrigida do Yelp. Inicie, navegue até All Help , pressione Ctrl + S e digite por exemplo calculator e pressione Enter :

   

   Mas parece que a pesquisa funciona apenas em títulos, não em texto completo.