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:

% # Be sure that the length of the lines will fit into the small help window % # here and in the Roosevelt quote below.
=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:

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