CHM build issues
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 35/100
- issue の種類
- バグ
- 明瞭さ
- 説明が足りない
- 活発さ
- 活発
- 技術スタック
- php
調査の方向性
phpdotnet/phd/Package/PHP/HOWTO.GENERATE_CHM から始め、報告されている HTMLHelp Workshop と Free Pascal chmcmd の失敗を確認してください。可能であれば、欠落ファイルの警告と Windows での読み込み失敗を含めて、CHM のビルドを再現してください。完了の条件は、動作するツールと手順が文書化されていること、または CHM のサポートを廃止する明確な根拠があることです。
索引モデルが issue の本文から書いたものです。
説明
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 ontrueandfalseWarning: 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.
- 主要言語
- PHP
- スター
- 91
- フォーク
- 59
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
php/phd のほかの issue
-
難易度 4/5 3〜5日 初心者へのやさしさ 50/100
-
難易度 3/5 1〜2日 初心者へのやさしさ 65/100
-
難易度 4/5 3〜5日 初心者へのやさしさ 35/100
-
難易度 4/5 3〜5日 初心者へのやさしさ 52/100
-
難易度 3/5 1〜2日 初心者へのやさしさ 65/100
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
thephpleague/commonmark#1159 ·
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
awslabs/aidlc-workflows#1879 ·
メンテナーはふだん 1 日以内に返信
-
[Bug] The PHP file that lists DNS records truncates records to 12 characters?対応中かも @sahsanu が今日担当しました。 オープンbug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
hestiacp/hestiacp#5769 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
bug customer-reported
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
MagnaCapax/PMSS#1011 ·
メンテナーはふだん 5 日以内に返信
-
Talk Review
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
socallinuxexpo/scale-drupal#351 ·