(r1) PluggableRenderers < Development

You are here: Foswiki>Development Web>ReleaseProcess>FeatureRequest>PluggableRenderers (revision 1) (raw view)

---+!! Feature Proposal: Make Foswiki::Render pluggable

%TOC%

---++ Motivation

Foswiki::Render is a major weakness of Foswiki. Let's make it pluggable, so we can explore deep changes or even replacement in a robust way without disrupting our wider userbase.

The following bugs in particular are quite painful and would benefit from more adventurous explorations of =Foswiki::Render=:

%FORMAT{
  "Tasks.Item11316, Tasks.Item11366, Tasks.Item9771"
  format="   * [[$web.$topic][$topic]] $formfield(Summary)"
}%

---++ Description and Documentation

There are these main ways to get TML rendered, AFAICS:
   * =Foswiki::Func::renderText( $text, $web, $topic ) -&gt; $html= - official API
   * =Foswiki::Meta-&gt;renderTML($tml) -&gt; $html= - Semi-official API
   * =Foswiki::Render::getRenderedVersion($tml, $topicObject) -&gt; $html= - legacy; many plugins in svn
   * =$session-&gt;renderer()-&gt;getRenderedVersion($tml, $topicObject) -&gt; $html= - core, tests & some plugins

Need to make all these forms wrappers to a thing which determines the correct renderer class for the job.
---++ Examples

---++ Impact
   * Performance
   * Must support an eventual [[FoswikiDOM]] renderer
   * Should allow different renderers to be used for different content-types (actual content negotiation is outside the scope of this proposal, except that this work should support an a future content-negotiation mechanism).
---++ Implementation

-- __Contributors:__ Main.PaulHarvey - 01 Feb 2012

---++ Discussion

ChangeProposalForm edit

TopicSummary	Make Foswiki::Render pluggable
CurrentState	UnderInvestigation
CommittedDeveloper
ReasonForDecision	None
DateOfCommitment
ConcernRaisedBy
BugTracking
RelatedTopics	FoswikiDOM, MIMETypeForWikiSyntax
PlannedFor

Topic revision: r1 - 01 Feb 2012, PaulHarvey

Development

Quick Links

Tools

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. see CopyrightStatement.