¿Puedo instalar una página de hombre usando la especificación gem?

Question

¿Hay alguna forma de instalar páginas man utilizando la especificación gem? Por ejemplo, gem install XXX-1.0.0.gem debería instalar la página de manual en el sistema.

Answer 1

Puede usar la gema gem-man para instalar las páginas de manual de gemas.

También ofrecen un "interruptor trampa" para usar el hombre mundial: alias man="gem man -s"

Answer 2

Rubygems actualmente no es compatible con la instalación de páginas de manual para las gemas.

A patch se envió a Rubygems hace un tiempo para agregar soporte para páginas de manual, pero fue rechazado.

Answer 3

creo que he encontrado una solución:

En primer lugar, hay que añadir una extensión nativa de la gema:

my_gem.gemspec: 

s.extensions << 'manpage/extconf.rb' 
s.files << 'manpage/my_gem.1' 

Entonces gem install ejecutará la extconf.rb y quiere llamar a un Makefile.

make clean 
make 
make install 

Así que la extconf.rb se puede utilizar para crear el Makefile. También debe asegurarse de que debe haber al menos un archivo Makefile ficticio o de lo contrario la instalación fallará.

makefile = "make:\n" \ 
      "\t%s\n" \ 
      "install:\n" \ 
      "\t%s\n" \ 
      "clean:\n" \ 
      "\t%s\n" 

if RUBY_PLATFORM =~ /linux/ 

    clean = 'sudo rm -f /usr/local/share/man/man1/my_gem.1.gz' 
    make = 'gzip my_gem.1' 
    install = 'sudo cp -r my_gem.1.gz /usr/local/share/man/man1/' 

    puts 
    puts 'You need super user privileges to install the manpage for my_gem.' 
    puts 'Do you want to proceed? (y/n)' 
    puts 'The gem will be installed anyways.' 
    input = STDIN.gets.chomp.strip.downcase 

    if input == 'y' or input == 'yes' 
    File.write('Makefile', makefile % [make, install, clean]) 
    else 
    File.write('Makefile', makefile % [':', ':', ':']) # dummy makefile 
    end 

else 
    File.write('Makefile', makefile % [':', ':', ':']) # dummy makefile 
end