[jira] Commented: (DERBY-4906) HTML pages contain links to local content

["Kim Haase (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DERBY-4906?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12932959#action_12932959 ] 

Kim Haase commented on DERBY-4906:
----------------------------------

To prevent the stylesheet from being shown as an absolute path, the docs.properties file needs to contain the following line:

args.csspath=

DERBY-4349 added this line to the docs.properties file in the trunk. Before that, a release manager had to remember to add it. This meant that many doc releases and the latest alpha docs contained an absolute pathname. 

It would be good to clean up those that still have this.

> HTML pages contain links to local content
> -----------------------------------------
>
>                 Key: DERBY-4906
>                 URL: https://issues.apache.org/jira/browse/DERBY-4906
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Web Site
>    Affects Versions: 10.2.2.0, 10.3.3.0, 10.4.2.0, 10.5.3.0
>            Reporter: Kristian Waagan
>
> Some of the documentation published on the ASF web server contain links to local content.
> For instance:
> <link href="/Users/rh161140/derby/docs/10.4/out/reftemp/commonltr.css" type="text/css" rel="stylesheet" />
> Two questions come to mind:
>  a) How do we fix it?
>  b) Why did it happen?
> For (a), I say we can either redeploy the docs, or we can do a search and replace. The latter is clearly the easiest.
> Regarding (b), I observe that the problem hasn't occurred for all docs builds. Are there weak spots in the instructions we can improve to make sure this won't happen again?

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.