Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

CHM build issues

Abierto
  • ¿Algo no está bien?
#203 29 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
35/100
Tipo de issue
Error
Claridad
Necesita aclaración
Estado de actividad
Activo
Stack tecnológico
php
Área
build-system, documentation

Línea de trabajo

Comienza con phpdotnet/phd/Package/PHP/HOWTO.GENERATE_CHM y revisa los fallos notificados de HTMLHelp Workshop y Free Pascal chmcmd. Reproduce la compilación de CHM si es posible, incluidas las advertencias sobre archivos faltantes y el fallo de carga en Windows. Se considera completado cuando se hayan documentado las herramientas y los pasos que funcionan, o exista una base clara para eliminar el soporte de CHM.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Attempted to build the CHM (non-enhanced) version of the manual and while the build itself appears to work, I ran into issues compiling the output into a chm file.

There's some CHM build instructions at https://github.com/php/phd/blob/master/phpdotnet/phd/Package/PHP/HOWTO.GENERATE_CHM but as you'll see from my notes below, they're not very helpful.

The first issue I encountered is that HTMLHelp Workshop (which contains the HTMLHelp Compiler) will not install on Windows 11 (installer errors saying a newer version is already installed).

Additionally I should note HTMLHelp Workshop no longer appears to be available for download from Microsoft (there's web documentation for it, but none of the download links leads anywhere. The closest I could find was this MS Answers post linking to an archive.org copy

I then tried the chmcmd compiler from freepascal on Linux (I was using fpc 3.2.2 on Gentoo). While this appeared to create a .chm file, this file failed to load on Windows 11. Additionally it output an Access Violation error.

chmcmd produced a number of warnings relating to content during the build. The most common 2 were:

  • Warning: Found file res/language.types.value.html while scanning res/<filename>.html, but couldn't find it on disk - appears to be caused by specific instances of the <type> tag on true and false
  • Warning: Found file res/ while scanning res/mongodb.persistence.html, but couldn't find it on disk - appears to be caused by anchors with no file attached. I think created by (for example) <footnoteref linkend="mongodb.pclass"/>

Does anyone have working instructions / tools to build the chm version of the manual?

The apparent lack of tools for building CHMs (I did have a search but there weren't many options, never mind free and maintained options) has me moving towards suggesting dropping support for CHM.

Lenguaje dominante
PHP
Estrellas
91
Forks
59
Sin PR fusionados en 30 d

Preparar el entorno

Aún no hemos revisado los archivos de configuración de este proyecto. Empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de php/phd

Todos los issues de php/phd

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.