EmbeddedPage

Background and rationale

MoinMoin page content included from other pages using the FormattedPage.py macro or other similar macros (e.g. <<Include()>> and <<IncludePage()>>) contain links that potentially cause the browser to leave the current page or that are inoperative. However, the Collect.py parser seeks to combine several pages under a cover page and have all links to the collected pages operate within the context of the current page. This is achieved using the helper macro, EmbeddedPage.

Description

EmbeddedPage post-processes HTML from a formatted page to convert URL references to anchor links for the sister pages provided in the arguments. It also changes HTML heading tag ids to match the anchor links. This macro imports the FormattedPage.py marco and is used when embedding one or more wiki pages into the current page. It is a helper macro for the Collect.py parser.

The post processing converts URL references to the target or sister pages provided to anchor links relative to the host page. It also deletes any suffixes added to anchors, heading ids and anchor links added by the formatter, so that they operate effectively from the host page.

Usage

<<EmbeddedPage(pagelist)>>

Arguments "targetindex" and "pagelist" are both required.

<<EmbeddedPage(targetindex, pagelist)>>

"targetindex" is an 0-based index for the target page in the page list.

"pagelist" is a comma-delimited list of pages included in the collection. 

If no index or list is provided, the macro returns nothing. No error message is returned.

Examples

See collect.py parser for examples of it use.

Download & Release Notes

Copyright

• @copyright: 2014 Ian Riley <ian@riley.asia>

License

GNU GPL, see COPYING for details.

Known issues and limitations

• None known

---

Hits

488