Sumary don't working about pelican-plugins

[warner]

I don't know how to fix this yet, but I did find the problem: for .rst files, the <!-- PELICAN_END_SUMMARY --> marker gets HTML-escaped before the summary scanner runs, so it gets <!-- PELICAN_END_SUMMARY --> and doesn't recognize the end marker.

To fix this, either the scanner needs to run before HTML escaping happens, or the scanner should HTML-escape the markers that it's looking for.

[oliverguenther]

While I cannot provide a fix for the escaping in the summary plugin itself, using a raw role provides a workaround. While the use of raw is discouraged in rst (because it forces the output format), it shouldn't be a problem within pelican, as the target platform is html anyway.

.. raw:: html

    <!-- PELICAN_END_SUMMARY -->

[warner]

what I ended up doing was to use settings.py to change the markers into something that doesn't get escaped:

SUMMARY_BEGIN_MARKER = "!BEGIN-SUMMARY!"
SUMMARY_END_MARKER = "!END-SUMMARY!"

Works for me: the plugin strips the markers, so they don't actually need to be comments.

[edelooff]

This is a documentation lack if anything. For reST, the proper way to mark a comment is to have to periods at the start of the line (..). When placing the summary markers like that, everything works fine:

..  PELICAN_BEGIN_SUMMARY

Some content.

..  PELICAN_END_SUMMARY

This part of the post is not included in the summary.

[warner]

/me nods. Although I suspect that would force you to use whole paragraphs as the summary (instead of allowing the use of just a few sentences, which sometimes flows better).

[edelooff]

Yeah, that is a limitation. The alternative is changing the marker of
course. I find paragraphs work well enough but YMMV.
On Jun 9, 2014 10:26 PM, "Brian Warner" [email protected] wrote:

/me nods. Although I suspect that would force you to use whole paragraphs
as the summary (instead of allowing the use of just a few sentences, which
sometimes flows better).

—
Reply to this email directly or view it on GitHub
#151 (comment)
.