(Documentation) PHP download of Many Html .tar.gz has JS hardcoded to php-chunked-xhtml dir
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 55/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 冷清
- 技术栈
- javascript, php
调研方向
下载并解压 https://www.php.net/distributions/manual/php_manual_en.tar.gz,重命名 php-chunked-xhtml 目录,并检查手册的 Search 控件所使用的随附 JavaScript。重命名目录后重现搜索框卡住的问题,然后验证从任意基础目录名称运行时搜索和关闭功能都能正常工作。
由索引模型根据 Issue 内容生成。
描述
Affected Page URL
https://www.php.net/distributions/manual/php_manual_en.tar.gz
Describe the bug
This is an oddity. I always download the many html tar-gzipped archive and host locally under phpdoc. When installing the current documentation the archive extracts to ./php-chunked-xhtml/. If you rename that directory, then choosing "Search" leaves a non-function search-box stuck at the bottom of the screen that cannot be closed with the [x] button displayed or Esc as displayed below text-search box.
Restoring the original extraction directory name to ./php-chunked-xhtml/ restores the javascript functionality.
This was surprising as all functionality should be relative to the siteroot, not hardcoded based on the base directory in the archive.
Steps to reproduce
- download https://www.php.net/distributions/manual/php_manual_en.tar.gz
- extract to a directory accessible on your web server
- rename the directory to something convenient to remember, e.g.
mv php-chunked-xhtml somedir - access the manual through
somedir - click search
- now try and use search or try and get rid of the search box and notation at the bottom of the page
Expected behavior
The documentation and javascript shipped with it should work regardless of the name used for the base directory. A functionality should be relative to that base directory regardless of what it is called.
Screenshots
Not Relevant
Additional context
This is a minor documentation issue, but surprising in documentation shipped by PHP. If you need more information, just ask and I'm happy to provide it, but this is pretty simple.
- 主要语言
- PHP
- 星标
- 1.1k
- 派生
- 641
- 平均合并
- 22 小时 36 分钟
- 30 天内合并 PR
- 16
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
php/web-php 的其他 Issue
-
Bug Status: Needs Triage
难度 2/5 1-3 小时 新手友好度 75/100
-
Page: downloads
难度 3/5 1-2 天 新手友好度 55/100
-
Page: downloads
难度 3/5 1-2 天 新手友好度 62/100
-
Bug Status: Needs Triage
难度 3/5 1-2 天 新手友好度 45/100
-
Bug Status: Needs Triage
难度 4/5 3-5 天 新手友好度 50/100
相似的 Issue
-
priority: p3
难度 2/5 1-3 小时 新手友好度 72/100
googleapis/librarian#7636 ·
-
0. Needs triage bug
难度 2/5 1-3 小时 新手友好度 78/100
nextcloud/fulltextsearch#1011 ·
-
难度 1/5 1 小时以内 新手友好度 90/100
coollabsio/coolify#11927 ·
-
难度 2/5 1-3 小时 新手友好度 84/100
-
难度 2/5 1-3 小时 新手友好度 68/100