Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

CHM build issues

Aperta
#203 29 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
35/100
Tipo di issue
Bug
Chiarezza
Da chiarire
Stato di attività
Attiva
Stack tecnologico
php
Ambito
build-system, documentation

Direzione di ricerca

Inizia da phpdotnet/phd/Package/PHP/HOWTO.GENERATE_CHM e analizza i malfunzionamenti segnalati di HTMLHelp Workshop e Free Pascal chmcmd. Riproduci la build di CHM, se possibile, incluse le avvertenze sui file mancanti e il malfunzionamento del caricamento su Windows. Il lavoro è completato quando sono documentati gli strumenti e i passaggi funzionanti, oppure esiste una base chiara per abbandonare il supporto a CHM.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
PHP
Stelle
91
Fork
59
Nessuna PR unita negli ultimi 30g

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di php/phd

Tutte le issue di php/phd

Issue simili

Altre issue su PHP

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.