You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@struts.apache.org by "Ted Husted (JIRA)" <ji...@apache.org> on 2006/06/13 00:07:16 UTC

[jira] Created: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Develop routine for exporting wiki to HTML/PDF
----------------------------------------------

         Key: WW-1346
         URL: http://issues.apache.org/struts/browse/WW-1346
     Project: Struts Action 2
        Type: Task

  Components: Documentation  
    Reporter: Ted Husted
    Priority: Critical
     Fix For: 2.0.0




-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Resolved: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/struts/browse/WW-1346?page=all ]

Ted Husted resolved WW-1346.
----------------------------

    Resolution: Fixed

I might yet setup the cron job, but I've found that using a spider like httrack , creates a useful copy of the documentation (so long as there are no orphan pages). 

I'm still hacking it into the distribution, so the routine is not automated, but there is at least a routine. 




> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>                 Key: WW-1346
>                 URL: http://issues.apache.org/struts/browse/WW-1346
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Ted Husted
>            Priority: Critical
>             Fix For: 2.0.0
>
>
> STATUS: 
> * Our request for the ASF wiki is pending. 
> * The AutoExport plugin is installed at twdata.org, so that a current export is available at [http://www.twdata.org/backups/WW/]
> * Test export: http://struts.apache.org/2.x/docs/Home.html
> We also need to document installing the "snippet" macro, so that this can be done at the ASF and elsewhere. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37565 ] 

Ted Husted commented on WW-1346:
--------------------------------

I put a static copy of the documentation up at 

* http://struts.apache.org/struts-action2/docs/Home.html

but, the image references are not resolving correctly.

The references are to locations like 

* /images/icons/emoticons/forbidden.gif

so I coped the appropriate images to 

/www/struts.apache.org/images/icons/ 

and checked to be sure that 

images/icons/emoticons/forbidden.gif

existed from /www/struts.apache.org 

but, the images are either not being copied to the production server, or there is something happening with the reference that I don't see. 

Once we have the export sorted out, we may need to add a frame to provide a left sidebar, as we have on the wiki site. 

* http://confluence.twdata.org/homepage.action

-Ted

> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>          Key: WW-1346
>          URL: http://issues.apache.org/struts/browse/WW-1346
>      Project: Struts Action 2
>         Type: Task

>   Components: Documentation
>     Reporter: Ted Husted
>     Priority: Critical
>      Fix For: 2.0.0

>


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37741 ] 
            
Ted Husted commented on WW-1346:
--------------------------------

I tried to do an XML space export from here, but it seems to be stalling again. 

-T.


> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>                 Key: WW-1346
>                 URL: http://issues.apache.org/struts/browse/WW-1346
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Ted Husted
>            Priority: Critical
>             Fix For: 2.0.0
>
>
> Test export: http://struts.apache.org/2.0/docs/Home.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Don Brown (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37560 ] 

Don Brown commented on WW-1346:
-------------------------------

FWIW, I've found you can export the site manually to HTML.  You have to wait about 10 minutes or so, but it comes through.  Were you talking about something more routine than that?  We should start pushing infra for a space on the Apache Confluence wiki.

> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>          Key: WW-1346
>          URL: http://issues.apache.org/struts/browse/WW-1346
>      Project: Struts Action 2
>         Type: Task

>   Components: Documentation
>     Reporter: Ted Husted
>     Priority: Critical
>      Fix For: 2.0.0

>


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Updated: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/struts/browse/WW-1346?page=all ]

Ted Husted updated WW-1346:
---------------------------

    Description: 
STATUS: 

* Our request for the ASF wiki is pending. 
* The AutoExport plugin is installed at twdata.org, so that a current export is available at [http://www.twdata.org/backups/WW/]

* Test export: http://struts.apache.org/2.x/docs/Home.html



  was:
Test export: http://struts.apache.org/2.0/docs/Home.html



> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>                 Key: WW-1346
>                 URL: http://issues.apache.org/struts/browse/WW-1346
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Ted Husted
>            Priority: Critical
>             Fix For: 2.0.0
>
>
> STATUS: 
> * Our request for the ASF wiki is pending. 
> * The AutoExport plugin is installed at twdata.org, so that a current export is available at [http://www.twdata.org/backups/WW/]
> * Test export: http://struts.apache.org/2.x/docs/Home.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Don Brown (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37562 ] 

Don Brown commented on WW-1346:
-------------------------------

Well, I did do a few things to clear some memory on that box, so perhaps that made a difference.  Who knew 2.5 gigs could go that quickly :)

> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>          Key: WW-1346
>          URL: http://issues.apache.org/struts/browse/WW-1346
>      Project: Struts Action 2
>         Type: Task

>   Components: Documentation
>     Reporter: Ted Husted
>     Priority: Critical
>      Fix For: 2.0.0

>


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37561 ] 

Ted Husted commented on WW-1346:
--------------------------------

Hmmm, a month ago, it wouldn't finish an export even if you let it run for ten hours. We've deleted a numbrer of pages since them, so perhaps we've fallen below some magic ceiling. In any event, it's exporting now, and that's good enough for me! I opened an INFRA ticket for requesting a Confluence instance. 

* http://issues.apache.org/jira/browse/INFRA-851

-T.


> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>          Key: WW-1346
>          URL: http://issues.apache.org/struts/browse/WW-1346
>      Project: Struts Action 2
>         Type: Task

>   Components: Documentation
>     Reporter: Ted Husted
>     Priority: Critical
>      Fix For: 2.0.0

>


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37833 ] 
            
Ted Husted commented on WW-1346:
--------------------------------

Don, now that we have the autoexport working, would it be possible to add a cron job that zips up the html files at least every day, so that they could be downloaded? 

A download would give us a way to integrate a snapshot of the wiki documentation (which is all fo our s2 documentation) into a distribution.



> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>                 Key: WW-1346
>                 URL: http://issues.apache.org/struts/browse/WW-1346
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Ted Husted
>            Priority: Critical
>             Fix For: 2.0.0
>
>
> STATUS: 
> * Our request for the ASF wiki is pending. 
> * The AutoExport plugin is installed at twdata.org, so that a current export is available at [http://www.twdata.org/backups/WW/]
> * Test export: http://struts.apache.org/2.x/docs/Home.html
> We also need to document installing the "snippet" macro, so that this can be done at the ASF and elsewhere. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37812 ] 
            
Ted Husted commented on WW-1346:
--------------------------------

See also "Confluence wiki for Struts" on infrastructure list. 


> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>                 Key: WW-1346
>                 URL: http://issues.apache.org/struts/browse/WW-1346
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Ted Husted
>            Priority: Critical
>             Fix For: 2.0.0
>
>
> Test export: http://struts.apache.org/2.0/docs/Home.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Don Brown (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37722 ] 

Don Brown commented on WW-1346:
-------------------------------

Agreed, the sooner we move it over the better.

> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>          Key: WW-1346
>          URL: http://issues.apache.org/struts/browse/WW-1346
>      Project: Struts 2
>         Type: Task

>   Components: Documentation
>     Reporter: Ted Husted
>     Priority: Critical
>      Fix For: 2.0.0

>


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37631 ] 

Ted Husted commented on WW-1346:
--------------------------------

I just setup Pier's autoexport plugin for another site, and it's working just great for me! 

* http://could.it/autoexport/index.html

It listens for changes, and exports each page as it is saved, so that that static site stays up to date. 

If we install this on twdata, we might also need to update the nekohtml jars. It needs 0.9.5, and my Confluence 2.1.2 used 0.8.1. Dunno about 2.1.5a.

On my own project, we have Tomcat running on 80 and HTTPD running on 8080, and we export the spaces to an HTTPD folder. 

To get it over to struts.apache.org, we could do something kludgy like 

0 | Check the autoexport site into SVN |
1 | Check out the site to people.apache.or:/www/struts.apache.org/struts2/docs |

1 | On a daily basis, have a twdata.org chron update the SVN | 
2 | Update the Struts site from SVN (can we automate this?) |

I expect when we get an instance on an ASF machine (INFRA-851), we'll be able to use this to publish the S2 documentation directly, and won't have to go around Robin Hood's barn.

When we do get around to moving the site, I'd like to also visit the issue of renaming the JIRA and Confluence keys to "STRUTS1" and "STRUTS2", to match the repository and package names.  It's not trivial, but it is possible. We were using other keys for historical reasons, but I think we've reached the point where we need to be looking forward instead of looking back. 



> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>          Key: WW-1346
>          URL: http://issues.apache.org/struts/browse/WW-1346
>      Project: Struts 2
>         Type: Task

>   Components: Documentation
>     Reporter: Ted Husted
>     Priority: Critical
>      Fix For: 2.0.0

>


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Updated: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/struts/browse/WW-1346?page=all ]

Ted Husted updated WW-1346:
---------------------------

    Description: 
STATUS: 

* Our request for the ASF wiki is pending. 
* The AutoExport plugin is installed at twdata.org, so that a current export is available at [http://www.twdata.org/backups/WW/]

* Test export: http://struts.apache.org/2.x/docs/Home.html

We also need to document installing the "snippet" macro, so that this can be done at the ASF and elsewhere. 


  was:
STATUS: 

* Our request for the ASF wiki is pending. 
* The AutoExport plugin is installed at twdata.org, so that a current export is available at [http://www.twdata.org/backups/WW/]

* Test export: http://struts.apache.org/2.x/docs/Home.html




> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>                 Key: WW-1346
>                 URL: http://issues.apache.org/struts/browse/WW-1346
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Ted Husted
>            Priority: Critical
>             Fix For: 2.0.0
>
>
> STATUS: 
> * Our request for the ASF wiki is pending. 
> * The AutoExport plugin is installed at twdata.org, so that a current export is available at [http://www.twdata.org/backups/WW/]
> * Test export: http://struts.apache.org/2.x/docs/Home.html
> We also need to document installing the "snippet" macro, so that this can be done at the ASF and elsewhere. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37953 ] 
            
Ted Husted commented on WW-1346:
--------------------------------

The wiki is now available at http://cwiki.apache.org/confluence and being autoexported to http://cwiki.apache.org/WW/home.html. 

The next trick would be to get a cron job (or the autoexport plugin)  to ZIP up the website, so that we could just download the current HTML export, and bundle it with a distribution. I suggested adding the feature to autoexport. 

* http://could.it/bugs/browse/EXP-21

I also tried getting a space export from cwiki, but doing so exposed a proxy error.  The space is a bit too big, I expect.

-Ted.


> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>                 Key: WW-1346
>                 URL: http://issues.apache.org/struts/browse/WW-1346
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Ted Husted
>            Priority: Critical
>             Fix For: 2.0.0
>
>
> STATUS: 
> * Our request for the ASF wiki is pending. 
> * The AutoExport plugin is installed at twdata.org, so that a current export is available at [http://www.twdata.org/backups/WW/]
> * Test export: http://struts.apache.org/2.x/docs/Home.html
> We also need to document installing the "snippet" macro, so that this can be done at the ASF and elsewhere. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/struts/browse/WW-1346?page=all ]

Ted Husted updated WW-1346:
---------------------------

    Description: 
Test export: http://struts.apache.org/2.0/docs/Home.html


> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>                 Key: WW-1346
>                 URL: http://issues.apache.org/struts/browse/WW-1346
>             Project: Struts 2
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Ted Husted
>            Priority: Critical
>             Fix For: 2.0.0
>
>
> Test export: http://struts.apache.org/2.0/docs/Home.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37720 ] 

Ted Husted commented on WW-1346:
--------------------------------


This is definately a "Rube Goldberg" solution, but using tools available right now today, we could 

* Autoexport Plugin outputs Confluence space to HTML at location on twdata.org 
* Cron job on twdata.org creates/refreshes zip archive of exported HTML in a downloadable location 
* Build grabs HTML zip archive from twdata.org and freshens local copy of exported website
* Build assembles exported website and Maven output into a uniified website

>From here we could scp the website as usual, but as it turns out, infra@ would like us to have a copy of the struts.apache.org website checked into Subversion.  So, we could check that into the repository at struts/docs/trunk.  include that with struts-current,  and then 

* Build copies website files to current/docs  
* Committer checks in docs folder to repository
* Committer or cron job updates website from repository

-Ted.


> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>          Key: WW-1346
>          URL: http://issues.apache.org/struts/browse/WW-1346
>      Project: Struts 2
>         Type: Task

>   Components: Documentation
>     Reporter: Ted Husted
>     Priority: Critical
>      Fix For: 2.0.0

>


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (WW-1346) Develop routine for exporting wiki to HTML/PDF

Posted by "Ted Husted (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/struts/browse/WW-1346?page=comments#action_37721 ] 

Ted Husted commented on WW-1346:
--------------------------------

I just noticed that on infra@ someone just asked about importanting a Confluence space, and Jeff Turner said to make the dump available on people.apache.org, and he would take care of it. 

This might be a good time to get the struts2 docs moved over. 

-Ted.


> Develop routine for exporting wiki to HTML/PDF
> ----------------------------------------------
>
>          Key: WW-1346
>          URL: http://issues.apache.org/struts/browse/WW-1346
>      Project: Struts 2
>         Type: Task

>   Components: Documentation
>     Reporter: Ted Husted
>     Priority: Critical
>      Fix For: 2.0.0

>


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/struts/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira