Compile Guide and Blog to CHM Compilable html #1950

Closed
mtangoo opened this Issue Jan 10, 2013 · 14 comments

Comments

Projects
None yet
4 participants
@mtangoo

mtangoo commented Jan 10, 2013

The API gets generated as nice HTML pages with .hhp, .hhc, .hhk files which can be compiled to CHM. No such feature exists for Guide/Blog. I request that it gets added
TIA,
Stefano

@mtangoo

This comment has been minimized.

Show comment
Hide comment
@mtangoo

mtangoo Jan 16, 2013

No comment? Anyone from Yii Dev Team?

mtangoo commented Jan 16, 2013

No comment? Anyone from Yii Dev Team?

@cebe

This comment has been minimized.

Show comment
Hide comment
@cebe

cebe Jan 16, 2013

Member

@mtangoo We will add it when we find the time for it. If you have time and know how to do it, you can add it yourself by sending a pull request.

Member

cebe commented Jan 16, 2013

@mtangoo We will add it when we find the time for it. If you have time and know how to do it, you can add it yourself by sending a pull request.

@mtangoo

This comment has been minimized.

Show comment
Hide comment
@mtangoo

mtangoo Jan 16, 2013

@cebe
I have not plenty time but at least some time. The problem is I don't know how to do it (though one can help me understand). I have opened thread for such help, see link below.

http://www.yiiframework.com/forum/index.php/topic/39409-building-guide-document-text-into-offline-chm-compilable-html/

mtangoo commented Jan 16, 2013

@cebe
I have not plenty time but at least some time. The problem is I don't know how to do it (though one can help me understand). I have opened thread for such help, see link below.

http://www.yiiframework.com/forum/index.php/topic/39409-building-guide-document-text-into-offline-chm-compilable-html/

@mtangoo

This comment has been minimized.

Show comment
Hide comment
@mtangoo

mtangoo Jan 18, 2013

The issue with the linked problem is solved. The API generates necessary files to compile to chm only that it does not compile it. So for anyone in need for CHM for API he will just need to instal HTML Workshop and do the compiling.

In my case however, there is even no HTML files to compile CHM from and this is my main issue. Is it so hard to make HTML available (I believe it is not since we have html version of an online Guide/Blog)?

If my guess is right, how do I generate it?

mtangoo commented Jan 18, 2013

The issue with the linked problem is solved. The API generates necessary files to compile to chm only that it does not compile it. So for anyone in need for CHM for API he will just need to instal HTML Workshop and do the compiling.

In my case however, there is even no HTML files to compile CHM from and this is my main issue. Is it so hard to make HTML available (I believe it is not since we have html version of an online Guide/Blog)?

If my guess is right, how do I generate it?

@samdark

This comment has been minimized.

Show comment
Hide comment
@samdark

samdark Jan 18, 2013

Member

@mtangoo check scripts in build dir.

Member

samdark commented Jan 18, 2013

@mtangoo check scripts in build dir.

@mtangoo

This comment has been minimized.

Show comment
Hide comment
@mtangoo

mtangoo Jan 18, 2013

@samdark, can you be specific which one?
I have tried to dig and I can say that I could not find anything I could utilize for Guide and blog.
API builds fine as well as PDFs.

I hope I'm missing something!

mtangoo commented Jan 18, 2013

@samdark, can you be specific which one?
I have tried to dig and I can say that I could not find anything I could utilize for Guide and blog.
API builds fine as well as PDFs.

I hope I'm missing something!

@samdark

This comment has been minimized.

Show comment
Hide comment
@samdark

samdark Jan 18, 2013

Member

Ah, nope, it's about APIs. For the blog and the guide I did my own scripts once https://github.com/yiiext/core/blob/master/app/commands/ChmCommand.php. Not sure if it's still functional.

Member

samdark commented Jan 18, 2013

Ah, nope, it's about APIs. For the blog and the guide I did my own scripts once https://github.com/yiiext/core/blob/master/app/commands/ChmCommand.php. Not sure if it's still functional.

@mtangoo

This comment has been minimized.

Show comment
Hide comment
@mtangoo

mtangoo Jan 19, 2013

@samdark Thanks for a script. I will check if not functional I will update.
Just curious why was it not included with docs and hence maintained?

mtangoo commented Jan 19, 2013

@samdark Thanks for a script. I will check if not functional I will update.
Just curious why was it not included with docs and hence maintained?

@mtangoo

This comment has been minimized.

Show comment
Hide comment
@mtangoo

mtangoo Jan 19, 2013

BTW, should I run just as any PHP file or I need to add somewhere in build script?
Can you enlighten me?

mtangoo commented Jan 19, 2013

BTW, should I run just as any PHP file or I need to add somewhere in build script?
Can you enlighten me?

@suralc

This comment has been minimized.

Show comment
Hide comment
@suralc

suralc Jan 19, 2013

Contributor

@mtangoo As it extends CConsoleCommand I would suggest you to try yiic ;D

Contributor

suralc commented Jan 19, 2013

@mtangoo As it extends CConsoleCommand I would suggest you to try yiic ;D

@mtangoo

This comment has been minimized.

Show comment
Hide comment
@mtangoo

mtangoo Jan 19, 2013

Mh! I have not tried yiic except when using to make webapp
should I run something like below? @suralc
yiic ChmCommand.php

mtangoo commented Jan 19, 2013

Mh! I have not tried yiic except when using to make webapp
should I run something like below? @suralc
yiic ChmCommand.php

@suralc

This comment has been minimized.

Show comment
Hide comment
@suralc

suralc Jan 19, 2013

Contributor

Haven't looked at the project, just assumed it from the file. However clone the project locally and it's submodules.

Copy over the guide folder of the yii repository into the app folder(cd app) and run chm <type> <lang> or console chm <type> <lang>(create runtime folder first).

However, chm creation failed for me (invalid charset, also failing for ru). (PHP 5.4) and I have no intention looking into it, yet.

D:\chm\core\app>console chm guide de mkdir ./files Processing: D:\chm\core\app\guide\de mkdir D:/chm/core/app/runtime/chmguide Creating CHM-project. Adding a window to the project. Coping assets to tmpdir. Reading toc.txt Parsing toc.txt items PHP Error[8]: iconv(): Wrong charset, conversion from 'UTF-8' to 'CP866//TRANSLI T//IGNORE' is not allowed in file D:\chm\core\app\commands\ChmCommand.php at line 153 #0 D:\chm\core\app\commands\ChmCommand.php(153): iconv() #1 D:\chm\core\yii\framework\console\CConsoleCommandRunner.php(63): ChmCommand-> run() #2 D:\chm\core\yii\framework\console\CConsoleApplication.php(88): CConsoleComman dRunner->run() #3 D:\chm\core\yii\framework\base\CApplication.php(158): CConsoleApplication->pr ocessRequest() #4 D:\chm\core\app\console.php(11): CConsoleApplication->run()
@mtangoo However there is a compiled chm of 1.1.13(works after unblocking):

#1935 (comment)

Contributor

suralc commented Jan 19, 2013

Haven't looked at the project, just assumed it from the file. However clone the project locally and it's submodules.

Copy over the guide folder of the yii repository into the app folder(cd app) and run chm <type> <lang> or console chm <type> <lang>(create runtime folder first).

However, chm creation failed for me (invalid charset, also failing for ru). (PHP 5.4) and I have no intention looking into it, yet.

D:\chm\core\app>console chm guide de mkdir ./files Processing: D:\chm\core\app\guide\de mkdir D:/chm/core/app/runtime/chmguide Creating CHM-project. Adding a window to the project. Coping assets to tmpdir. Reading toc.txt Parsing toc.txt items PHP Error[8]: iconv(): Wrong charset, conversion from 'UTF-8' to 'CP866//TRANSLI T//IGNORE' is not allowed in file D:\chm\core\app\commands\ChmCommand.php at line 153 #0 D:\chm\core\app\commands\ChmCommand.php(153): iconv() #1 D:\chm\core\yii\framework\console\CConsoleCommandRunner.php(63): ChmCommand-> run() #2 D:\chm\core\yii\framework\console\CConsoleApplication.php(88): CConsoleComman dRunner->run() #3 D:\chm\core\yii\framework\base\CApplication.php(158): CConsoleApplication->pr ocessRequest() #4 D:\chm\core\app\console.php(11): CConsoleApplication->run()
@mtangoo However there is a compiled chm of 1.1.13(works after unblocking):

#1935 (comment)

@mtangoo

This comment has been minimized.

Show comment
Hide comment
@mtangoo

mtangoo Jan 19, 2013

@suralc Thanks for detailed explanation. I will clone it and what you said and try to fix things. I need just english version for now.

The problem is I need the html plus hhk, hhc, hht files not CHM.

Thanks alot!

mtangoo commented Jan 19, 2013

@suralc Thanks for detailed explanation. I will clone it and what you said and try to fix things. I need just english version for now.

The problem is I need the html plus hhk, hhc, hht files not CHM.

Thanks alot!

@samdark

This comment has been minimized.

Show comment
Hide comment
@samdark

samdark Nov 9, 2016

Member

Closed because of 1.1 EOL.

Member

samdark commented Nov 9, 2016

Closed because of 1.1 EOL.

@samdark samdark closed this Nov 9, 2016

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment