[DOXIASITETOOLS-183] add edit source feature to document model (base url)

• Type: New Feature
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.7.5
• Fix Version/s: 1.8
• Component/s: Site model, Site renderer
• Assignee: Herve Boutemy
• Reporter: Herve Boutemy
• Created: 14/Dec/17 03:25
• Updated: 25/Jan/24 17:29
• Resolved: 21/Dec/17 15:07

Description

each skin/template should be able to generate an "edit" link that points to source file in scm

this requires a configuration in decoration model to define base scm url:

<project xmlns="http://maven.apache.org/DECORATION/1.8.0"
  xsi:schemaLocation="http://maven.apache.org/DECORATION/1.8.0 http://maven.apache.org/xsd/decoration-1.8.0.xsd"
  name=.. combine.self=.. >
[...] 
  <publishDate position=.. format=.. />
  <version position=.. />
  <edit>${project.scm.url}</edit>
[...] 

and API improvements to avoid proposing edition if a Doxia file is generated (target/generated-site by default)

Issue Links

• depends upon: DOXIASITETOOLS-181 add docRenderingContext to template Velocity context
• is depended upon by: MSKINS-139 add edit button to link to scm source
• is related to: DOXIASITETOOLS-187 edit value not inherited
• is related to: DOXIASITETOOLS-328 Allow to overwrite the edit source link with an alternative folder
• is required by: MSITE-804 update Doxia Site Renderer to 1.8