Use the Bulk Edit interface to edit all of the elements and subelements of
a given element at once. Different fields and elements are demarcated by lines
with special tags that start with an equals sign (=
) and have an
empty line separating them from content; anything else is considered
content.
Field elements are demarcated by =key_name
and an empty line,
where key_name
is the the key name of the field. For example, a
field with the key name paragraph
may be rendered as so:
=paragraph Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh eusmod tincidunt ut laoreet dolore magna aliquam erat volputate. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.
Container elements are demarcated by =begin key_name
and an empty
line, and then an =end key_name
tag at the end of the element.
The key name after the =end
tag is optional. Fields within
container elements go between these tags, like so:
=begin pull_quote =paragraph Ask not what your country can do for you. Ask what you can do for your country. =by John F. Kennedy =date 1961-01-20 00:00:00 =end pull_quote
Indentation of subelements is optional, although Bricolage will generate four-space indents for existing elements. If for some reason you must have a content line that starts with an equal sign, escape it with a backslash, like so:
=header \= Lorem ipsum dolor sit amet
Related stories and related media are indiciated by one of the following tags:
=related_story_uri
=related_media_uri
=related_story_url
=related_media_url
=related_story_uuid
=related_media_uuid
=related_story_id
=related_media_id
The URI, URL, UUID, or ID is then put on the same line as the tag.
Bricolage itself uses _uuid
tags for related documents. The
_uri
tags are probably simplest to use, but should not be used if
you manage multiple sites in Bricolage and different sites can use the same
URIs. The _url
tags avoid this problem by using a full URL for a
related document; the domain name from the URL will be used to look up the
appropriate site. Some examples:
=related_story_url http://www.example.com/reviews/books/ =related_media_uri /reviews/movies/2005/12/14/king_kong.png
These tags will create a relationship with the story with the URI
/reviews/books/
and associated with the site with the domain
www.example.com
, and with the media document with the URI
/reviews/movies/2005/12/14/king_kong.png
without regard to the site
to which it belongs.
Use the Default Field
select list to assign any untagged blocks of
content to a particular field. For example, if you selected paragraph
as the default field, the above pull quote element can be written as:
=begin pull_quote Ask not what your country can do for you. Ask what you can do for your country. =by John F. Kennedy =date 1961-01-20 00:00:00 =end pull_quote
Of course, all of these tags can be used to edit an entire hierarchy of an
element and its subelements, and this is where the default field becomes
especially useful. For example, to edit an entire story's worth of elements,
you might have something like this (again, with paragraph
selected as
the default field):
=related_media_uuid 4162F713-1DD3-11B3-B17F-C09EFE1DC404 =teaser This is where we teas you. Ha ha! =begin page This is a paragraph Second paragraph =header And then... Third paragraph =begin pull_quote Ask not what your country can do for you. Ask what you can do for your country. =by John F. Kennedy =date 1961-01-20 00:00:00 =end pull_quote 圳地在圭圬圯圩夙多夷夸妄奸妃好她如妁字存宇守宅安寺尖屹州帆并年 橿梶鰍潟割喝恰括活渇滑葛褐轄且鰹叶椛樺鞄株兜竃蒲釜鎌噛鴨栢茅萱 뼈뼉뼘뼙뼛뼜뼝뽀뽁뽄뽈뽐뽑뽕뾔뾰뿅뿌뿍뿐뿔뿜뿟뿡쀼쁑쁘쁜쁠쁨쁩삐 =begin pull_quote So, first of all, let me assert my firm belief that the only thing we have to fear is fear itself—nameless, unreasoning, unjustified terror which paralyzes needed efforts to convert retreat into advance. =by Franklin D. Roosevelt =date 1933-03-04 00:00:00 =end pull_quote Final paragraph. =end page