www-infrastructure-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Glen Mazza (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (INFRA-5378) Clarify instructions on running build_site.pl
Date Wed, 24 Oct 2012 16:32:13 GMT

    [ https://issues.apache.org/jira/browse/INFRA-5378?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13483365#comment-13483365

Glen Mazza commented on INFRA-5378:

No, we don't have to teach how to set PYTHONPATH, that's explained in a gazillion places already
on the 'Net.  Just to explain what additional python modules have to be there.  OTOH, it could
be, if you run markdownd.py from any directory where it's located, you don't need to add anything
to PYTHONPATH, so if we could have a PYTHONPATH-free solution that might be better.  BTW,
just to clarify, it doesn't matter where mdx_elementid is located, just as long as it's in
the same directory as markdownd.py?  *or* must mdx_elementid be in the /path/to/cms/build/tree?
 I'm not sure whether it's the former or latter that's the important point.

I'll try again this weekend to see if I can get it to work--maybe ask someone on the JSPWiki
team *precisely* how they run it and then come up with instructions I can update the pages
> Clarify instructions on running build_site.pl
> ---------------------------------------------
>                 Key: INFRA-5378
>                 URL: https://issues.apache.org/jira/browse/INFRA-5378
>             Project: Infrastructure
>          Issue Type: Improvement
>      Security Level: public(Regular issues) 
>          Components: CMS
>            Reporter: Glen Mazza
>            Priority: Minor
> Hi, the instructions on running build_site.pl (http://www.apache.org/dev/cmsref.html#local-build)
could use clarification in a couple of areas.  Trying to get it to run on the incubating Apache
JSPWiki website is raising errors for me (Error message: Filter 'markdown' couldn't be found
or an error occurred. The filter has to be in the Dotiac::DTL::Filter namespace -- Can't open
markdown socket: No such file or directory at /media/work1/opensource/cmsBuild/lib/Dotiac/DTL/Addon/markup.pm
line 56.) causing me to doubt some of the assumptions I was making from the instructions.
 Namely the instructions say: 
> "Once everything is installed you'll need to run
> $ cd /path/to/cms/build/tree
> $ export MARKDOWN_SOCKET=`pwd`/markdown.socket PYTHONPATH=`pwd`
> $ python markdownd.py"
> Clarification #1:  What is the precise "cms/build/tree" location referred to above? 
For JSP Wiki (http://svn.apache.org/viewvc/incubator/jspwiki/site/trunk/content/jspwiki/),
for example, is it the "site" folder, the "content" folder, or the "jspwiki" folder?
> Clarification #2: The script above implies I need to copy the markdownd.py script to
the cms/build/tree location (as I'm already in that folder due to the cd statement earlier)
Is that the case?  Let us know where we need to run markdownd.py -- can it be from the same
folder where we download it (i.e., where build_site.pl is) or do we have to copy it over to
cms/build/tree prior to running?
> Thanks!

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

View raw message