//// Included in: - user-manual: Attributes: Style //// // tag::intro[] The style attribute is the first positional attribute in an attribute list. It specifies a predefined set of characteristics that should apply to a block element or macro. For example, a paragraph block can be assigned one of the following built-in style attributes: * normal (default, so does not need to be set) * literal * verse * quote * listing * TIP * NOTE * IMPORTANT * WARNING * CAUTION * abstract * partintro * comment * example * sidebar * source // end::intro[] ==== Id // tag::id[] The id attribute specifies a unique name for an element. That name can only be used once in a document. An id has two purposes: . to provide an internal link or cross reference anchor for the element . to reference a style or script used by the output processor // end::id[] //// BlockId NOTE: Section pending //// ===== Block assignment // tag::bl[] In an attribute list, there are two ways to assign an id attribute to a block element. . Prefixing the name with a hash (`#`). . Specifying the name with `id=`. [source] ---- [#goals] * Goal 1 * Goal 2 ---- Let's say you want to create a blockquote from an open block and assign it an ID and role. You add `quote` (the block style) in front of the `#` (the ID) in the first attribute position, as this example shows: [source] ---- [quote#roads, Dr. Emmett Brown] ____ Roads? Where we're going, we don't need roads. ____ ---- TIP: The order of ID and role values in the shorthand syntax does not matter. CAUTION: If the ID contains a `.`, you must define it using either a longhand assignment (e.g., `id=classname.propertyname`) or the anchor shorthand (e.g., `+[[classname.propertyname]]+`). This is necessary since the `.` character in the shorthand syntax is the delimiter for a role, and thus gets misinterpreted as such. // end::bl[] ===== Inline assignment // tag::in[] The id (`#`) shorthand can be used on inline quoted text. .Quoted text block with id assignment using Asciidoctor shorthand ---- [#free_the_world]*free the world* ---- // end::in[] //// .Quoted text block with `id` assignment using traditional AsciiDoc syntax ---- [[free_the_world]]*free the world* ---- ////