Bug 885916

Summary:	RFE: Support navigation for docs without multi-page HTML format
Product:	[Community] Publican	Reporter:	Ruediger Landmann <rlandman>
Component:	publican	Assignee:	Jeff Fearn 🐞 <jfearn>
Status:	CLOSED CURRENTRELEASE	QA Contact:	tools-bugs <tools-bugs>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	3.0	CC:	aigao, rlandman+disabled
Target Milestone:	3.2	Keywords:	FutureFeature
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	4.0.0	Doc Type:	Enhancement
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-12-19 02:46:47 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Ruediger Landmann 2012-12-11 02:04:44 UTC

Description of problem:

Publican's internal navigation assumes that a multi-page HTML version of a doc will be available. This makes it difficult to incorporate legacy or upstream documentation in a different format (for example, PDF or ODT) into a Publican-generated website if we do not also have a HTML version available.
  
Actual results:

We need either to perform an expensive conversion of the docs to HTML, or to publish the doc in the "files" directory of a Publican document. 


Expected results:

Site navigation links directly to formats other than HTML if that's all that's available.

Comment 1 HSS Product Manager 2013-07-16 05:18:20 UTC

HSS-QE has reviewed and declined this request. QE for this bug will be handled by IED.

Comment 2 Jeff Fearn 🐞 2013-07-17 01:34:26 UTC

This is actually a much bigger change than I initially thought. It required updating WebSite.pm and most of the web site templates. Lots of QE will then be required for web sites.

Comment 3 HSS Product Manager 2013-09-18 05:29:13 UTC

HSS-QE has reviewed and declined this request. QE for this bug will be handled by IED.

Comment 4 Jeff Fearn 🐞 2013-09-20 02:58:24 UTC

Initial code checked in, need to discuss phrasing and layout for marker.

Comment 5 Jeff Fearn 🐞 2013-09-20 03:04:14 UTC

Note: this only works for existing supported formats. To support other fomrats you need to open a separate bug.

Comment 6 Ruediger Landmann 2013-09-23 01:59:38 UTC

(In reply to Jeff Fearn from comment #5)
> Note: this only works for existing supported formats. To support other
> fomrats you need to open a separate bug.

WFM; if we have docs in other formats, we should be able to convert at least to PDF.

Comment 8 Ruediger Landmann 2013-10-17 05:42:33 UTC

Verified with publican-3.9.9-0.fc19.t7.noarch