[ 
https://issues.apache.org/jira/browse/METRON-717?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Matt Foley updated METRON-717:
------------------------------
    Description: 
It is a minor nuisance that the site.xml file for the new site-book element is 
partly fixed source code (that must be versioned in git), and partly 
auto-generated code (that we would like git to ignore).  As a result, one gets 
frequent complaints from git regarding `modified:   
site-book/src/site/site.xml`, when really the only change is due to generated 
content during a site-book build.

Resolve issue by separating the generated part from the fixed part of site.xml, 
and tracking only the fixed part (in the form of a template file) in git.

  was:
It is a minor nuisance that the site.xml file for the new site-book element is 
partly fixed source code (that must be versioned in git), and partly 
auto-generated code (that we would like git to ignore).  As a result, one gets 
frequent complaints from git regarding `modified:   
site-book/src/site/site.xml`, when really the only change is due to generated 
content during a site-book build.

If doxia site plugin can handle either XInclude or Entity References, we can 
separate the generated part from the fixed part of site.xml, and resolve this 
issue.


> consider moving site.xml to .gitignore, and create site.xml.template as the 
> tracked file
> ----------------------------------------------------------------------------------------
>
>                 Key: METRON-717
>                 URL: https://issues.apache.org/jira/browse/METRON-717
>             Project: Metron
>          Issue Type: Bug
>            Reporter: Matt Foley
>
> It is a minor nuisance that the site.xml file for the new site-book element 
> is partly fixed source code (that must be versioned in git), and partly 
> auto-generated code (that we would like git to ignore).  As a result, one 
> gets frequent complaints from git regarding `modified:   
> site-book/src/site/site.xml`, when really the only change is due to generated 
> content during a site-book build.
> Resolve issue by separating the generated part from the fixed part of 
> site.xml, and tracking only the fixed part (in the form of a template file) 
> in git.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Reply via email to