Help:Embedded format

From semantic-mediawiki.org
Jump to: navigation, search
Embedded format
Embed selected articles.
Available languages
dezh-hans
Further Information
Provided by: Semantic MediaWiki
Added: 0.7
Removed: still supported
Requirements: none
Format name: embedded
Enabled by default: 
Indicates whether the result format is enabled by default upon installation of the respective extension.
yes
Authors: Markus Krötzsch
Categories: misc
Group:
Table of Contents

↓ INFO ↓

The result format embedded is used to embed the contents of the pages in a query result into a page. The embedding uses MediaWiki transclusion (like when inserting a template), so the tags <includeonly> and <noinclude> work for controlling what is displayed.

Parameters

General

Parameter Type Default Description
source text empty Alternative query source
limit whole number 50 The maximum number of results to return
offset whole number 0 The offset of the first result
link text all Show values as links
sort list of texts empty Property to sort the query by
order list of texts empty Order of the query sort
headers text show Display the headers/property names
mainlabel text no The label to give to the main page name
intro text empty The text to display before the query results, if there are any
outro text empty The text to display after the query results, if there are any
searchlabel text ... further results Text for continuing the search
default text empty The text to display if there are no query results

Format specific

Parameter Type Default Description
embedformat text h1 The HTML tag used to define headings
embedonly yes/no no Display no headings

The embedded format introduces the following additional parameters:

  • embedformat: this defines which kinds of headings to use when pages are embedded, may be a heading level, i.e. one of h1, h2, h3, h4, h5, h6, or a description of a list format, i.e. one of ul and ol
  • embedonly: if this parameter has any value (e.g. yes), then no headings are used for the embedded pages at all.

Example

The following creates a list of recent news posted on this site (like in a blog):

{{#ask:
 [[News date::+]]
 [[language code::en]]
 |sort=news date
 |order=descending
 |format=embedded
 |embedformat=h3
 |embedonly=yes
 |searchlabel= <br />[view older news]
 |limit=3
}}

This produces the following output:

Semantic MediaWiki 2.5.5 (SMW 2.5.5) has been released today as a new version of Semantic MediaWiki.

This maintenance release provides bugfixes and improvements. Please refer to the help page on installing Semantic MediaWiki to get detailed instructions on how to install or upgrade.

SMWCon Fall 2017 Registration open.

The registration for SMWCon Fall 2017 in Rotterdam, the Netherlands (October 4-6, 2017) is now open. All interested participants can now register at the registration site. Note that the Early Bird period ends on September 6, 2017.

The conference is organised by ArchiXL, Wikibase Solutions, the Open University in the Netherlands and Open Semantic Data Association (OSDA).

For more information on this and the conference, see the SMWCon Fall 2017 homepage.

Semantic MediaWiki 2.5.4 (SMW 2.5.4) has been released today as a new version of Semantic MediaWiki.

This new version brings a security fix for special page "SemanticMediaWiki". It also provides an improvement for software testing, other bugfixes and further increases platform stability. Since this release provides a security fix it is strongly advised to upgrade immediately! Please refer to the help page on installing Semantic MediaWiki to get detailed instructions on how to install or upgrade.
[view older news]

NoteNote: The newline (<br />) is used to put the further results link on a separate line.

Remarks

  • Note that by default this result format also adds all annotations from the pages that are being embedded to the page they are embedded to.1 Starting with Semantic MediaWiki 2.4.0Released on 9 July 2016 and compatible with MW 1.19.0 - 1.27.x. this can be prevented for annotations done via parser functions #set parser function and #subobject parser function by setting the embedonly parameter to "yes".2 in-text annotations will continue to be embedded. Thus these annotations need to be migrated to use the #set parser function to prevent this from happening.
  • Note that embedding pages may accidentally include category statements if the embedded articles have any categories. Use <noinclude> to prevent this, e.g. by writing <noinclude>[[Category:News feed]]</noinclude>. Starting with Semantic MediaWiki 3.0.0Released on an unknown date and compatible with MW 1.27.0 - 1.30.x. category statements will automatically be filtered from transcluded content. Thus the described trick to prevent this from happening is no longer necessary.
  • Note that Semantic MediaWiki will take care that embedded articles do not import their semantic annotations, so these need not be treated specifically.
  • Note that printout statements have no effect on embedding queries.

Limitations

You cannot use the embed format to embed a query from another page if that query relies on the magic word {{PAGENAME}}.


References

  1. ^  Semantic MediaWiki: GitHub issue gh:smw:1076
  2. ^  Semantic MediaWiki: GitHub pull request gh:smw:1455