Opened 19 months ago

Last modified 19 months ago

#6519 enhancement new

Provide a way to include a snippet of HTML you got from somewhere else into a document generated using t.w.template

Reported by: mwh Owned by:
Priority: normal Milestone:
Component: web Keywords:
Cc: jknight Branch:
Author: Launchpad Bug:

Description

I'm trying to port pydoctor to twisted.web.template and hit a basic problem: pydoctor uses epydoc to render the docstrings into HTML and there is no way to inject this into the output without re-parsing it into stan (and there's no a priori reason to suppose that epydoc will always give us XHTML, although I think it in fact does).

Change History (3)

comment:1 Changed 19 months ago by DefaultCC Plugin

  • Cc jknight added

comment:2 Changed 19 months ago by exarkun

  • Summary changed from t.w.template provides no way to include a snippet of HTML you got from somewhere else to Provide a way to include a snippet of HTML you got from somewhere else into a document generated using t.w.template
  • Type changed from defect to enhancement

comment:3 Changed 19 months ago by exarkun

(and there's no a priori reason to suppose that epydoc will always give us XHTML, although I think it in fact does).

Considering this, I wonder why you think it's a good idea to include it without parsing it. Sure, if it isn't XHTML (HTML5!!!) then you'll fail to parse it. On the same hand, if that's the case, then including it raw in the output is just handing the garbage on to the next piece of software down the line. No problem has really been solved.

Note: See TracTickets for help on using tickets.