Releasing dev as v4 (4.0.0)

_config.yml

@@ -28,18 +28,25 @@ menu:
       label: 'Guidelines versions'
       url: ''
       submenu:
-          - id: dev
-            url: 'dev'
+          #- id: dev
+            #url: 'dev'
+          - id: v4
+            url: 'v4'
           - id: v3
             url: 'v3'
 
 versions:
+    current: "v4"
+    editable: "v4"
+    # names
     dev: "development version"
-    current: "v3"
     v3: "3.0.0"
+    v4: "4.0.0"
 
 collections:
-  guidelines-dev:
+  #guidelines-dev:
+    #output: false
+  guidelines-v4:
     output: false
   guidelines-v3:
     output: false

_guidelines-dev/01-shared.md → _guidelines-v4/01-shared.md

@@ -1,7 +1,7 @@
 ---
 layout: sidebar
 sidebar: s1
-version: "dev"
+version: "v4"
 title: "Shared Elements, Models, and Attributes"
 sectionid: "shared"
 ---

_guidelines-dev/01-shared/01-sharedstructuralelements.md → _guidelines-v4/01-shared/01-sharedstructuralelements.md

@@ -1,5 +1,5 @@
 ---
 sectionid: sharedStructuralElements
 title: "Structural Elements"
-version: "dev"
+version: "v4"
 ---

_guidelines-dev/01-shared/01-sharedstructuralelements/01-shareddocumentelements.md → _guidelines-v4/01-shared/01-sharedstructuralelements/01-shareddocumentelements.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedDocumentElements
 title: "Document Elements"
-version: "dev"
+version: "v4"
 ---
 
 Typically, the following elements are available for the representation of the outermost structure of an MEI document:

_guidelines-dev/01-shared/01-sharedstructuralelements/02-sharedmusicelement.md → _guidelines-v4/01-shared/01-sharedstructuralelements/02-sharedmusicelement.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedMusicElement
 title: "Music Element"
-version: "dev"
+version: "v4"
 ---
 
 MEI texts may be regarded either as unitary; that is, forming an organic whole, or as composite; that is, consisting of several components which are in some important sense independent of each other. The distinction is not always entirely obvious. For example, a collection of songs might be regarded as a single item in some circumstances, or as a number of distinct items in others. In such borderline cases, the encoder must choose whether to treat the text as unitary or composite; each option may have advantages and disadvantages.

_guidelines-dev/01-shared/01-sharedstructuralelements/02-sharedmusicelement/01-sharedgroupedtexts.md → _guidelines-v4/01-shared/01-sharedstructuralelements/02-sharedmusicelement/01-sharedgroupedtexts.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedGroupedTexts
 title: "Grouped Texts"
-version: "dev"
+version: "v4"
 ---
 
 The {% include link elem="group" %} element may be used to represent a collection of independent musical texts which is to be regarded as a single unit for processing or other purposes. It is provided to simplify the encoding of collections, anthologies, and cyclic works. It can also be used to record the potentially complex internal structure of corpora, covered more fully in chapter {% include link id="corpus" %}.

_guidelines-dev/01-shared/01-sharedstructuralelements/02-sharedmusicelement/02-shareddivisionsbody.md → _guidelines-v4/01-shared/01-sharedstructuralelements/02-sharedmusicelement/02-shareddivisionsbody.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedDivisionsBody
 title: "Divisions of the Body"
-version: "dev"
+version: "v4"
 ---
 
 This section describes sub-division of the body of a musical text. Front and back matter are described in chapter {% include link id="text" %}.

_guidelines-dev/01-shared/01-sharedstructuralelements/02-sharedmusicelement/03-sharedmdivcontent.md → _guidelines-v4/01-shared/01-sharedstructuralelements/02-sharedmusicelement/03-sharedmdivcontent.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedMdivContent
 title: "Content of Musical Divisions"
-version: "dev"
+version: "v4"
 ---
 
 The {% include link elem="mdiv" %} element may contain one or both of two possible views: score and parts.

_guidelines-dev/01-shared/02-sharedmusicalelements.md → _guidelines-v4/01-shared/02-sharedmusicalelements.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedMusicalElements
 title: "Shared Musical Elements"
-version: "dev"
+version: "v4"
 ---
 
 This section lists the elements defined in the shared module that are available within the music element.

_guidelines-dev/01-shared/02-sharedmusicalelements/01-sharedscoreandparts.md → _guidelines-v4/01-shared/02-sharedmusicalelements/01-sharedscoreandparts.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedScoreAndParts
 title: "Score and Parts"
-version: "dev"
+version: "v4"
 ---
 
 The following elements are provided for the capture of scores and parts:

_guidelines-dev/01-shared/02-sharedmusicalelements/02-sharedstavesandlayers.md → _guidelines-v4/01-shared/02-sharedmusicalelements/02-sharedstavesandlayers.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedStavesAndLayers
 title: "Staves and Layers"
-version: "dev"
+version: "v4"
 ---
 
 The elements below are used to capture the logical organization of musical notation:

_guidelines-dev/01-shared/02-sharedmusicalelements/03-sharedbasicevents.md → _guidelines-v4/01-shared/02-sharedmusicalelements/03-sharedbasicevents.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedBasicEvents
 title: "Basic Music Events"
-version: "dev"
+version: "v4"
 ---
 
 The basic features of music notation are represented by the following elements:

_guidelines-dev/01-shared/02-sharedmusicalelements/04-sharedotherevents.md → _guidelines-v4/01-shared/02-sharedmusicalelements/04-sharedotherevents.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedOtherEvents
 title: "Other events"
-version: "dev"
+version: "v4"
 ---
 
 Because they can occur in the context of a stream of events on the staff, some elements which are used in other contexts are also treated as events. For example, in addition to being used to define the initial clef of a staff, the {% include link elem="clef" %} element can also be used to indicate a clef change.

_guidelines-dev/01-shared/02-sharedmusicalelements/04-sharedotherevents/01-sharedkeysignaturesandclefs.md → _guidelines-v4/01-shared/02-sharedmusicalelements/04-sharedotherevents/01-sharedkeysignaturesandclefs.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedKeySignaturesAndClefs
 title: "Key Signatures and Clefs"
-version: "dev"
+version: "v4"
 ---
 
 Key signatures and clefs as well as intra-staff changes to these musical parameters are treated as events.

_guidelines-dev/01-shared/02-sharedmusicalelements/04-sharedotherevents/02-sharedbarlines.md → _guidelines-v4/01-shared/02-sharedmusicalelements/04-sharedotherevents/02-sharedbarlines.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedBarlines
 title: "Bar Lines and Custos Signs"
-version: "dev"
+version: "v4"
 ---
 
 Measure separators, i.e., bar lines, and custos signs are also considered to be events.

_guidelines-dev/01-shared/02-sharedmusicalelements/04-sharedotherevents/03-sharedaccidentalsarticulations.md → _guidelines-v4/01-shared/02-sharedmusicalelements/04-sharedotherevents/03-sharedaccidentalsarticulations.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedAccidentalsArticulations
 title: "Accidentals, Articulation Symbols, Augmentation Dots, and Custos Signs"
-version: "dev"
+version: "v4"
 ---
 
 The following elements are regarded as events primarily because they sometimes occur independently of any associated notes, rests, or chords, especially in mensural and neume repertoires.

_guidelines-dev/01-shared/02-sharedmusicalelements/04-sharedotherevents/04-sharedlyricsyllables.md → _guidelines-v4/01-shared/02-sharedmusicalelements/04-sharedotherevents/04-sharedlyricsyllables.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedLyricSyllables
 title: "Lyric Syllables"
-version: "dev"
+version: "v4"
 ---
 
 The {% include link elem="syl" %} element is used to mark a word or portion of a word that is to be vocally performed. A fuller description of its use is provided in chapter {% include link id="lyricsSyl" %}.

_guidelines-dev/01-shared/02-sharedmusicalelements/04-sharedotherevents/05-sharednotespacing.md → _guidelines-v4/01-shared/02-sharedmusicalelements/04-sharedotherevents/05-sharednotespacing.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedNoteSpacing
 title: "Event Spacing"
-version: "dev"
+version: "v4"
 ---
 
 The following elements provide control over the horizontal spacing of notational events, such as notes, chords, rests, etc.:

_guidelines-dev/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks.md → _guidelines-v4/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedExpressionMarks
 title: "Expression Marks"
-version: "dev"
+version: "v4"
 ---
 
 Expression marks are instructions in the form of words, abbreviations, or symbols that convey aspects of performance that cannot be expressed purely through the musical notation.

_guidelines-dev/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/01-sharedtextdirectives.md → _guidelines-v4/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/01-sharedtextdirectives.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedTextDirectives
 title: "Text Directives"
-version: "dev"
+version: "v4"
 ---
 
 All of the following elements can be considered text directives; however, MEI uses the {% include link elem="dir" %} element specifically for words, abbreviations, numbers, or symbols specifying or suggesting the manner of performance that are not encoded elsewhere using the more specific elements of {% include link elem="tempo" %} and {% include link elem="dynam" %}.

_guidelines-dev/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/02-sharedtempomarks.md → _guidelines-v4/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/02-sharedtempomarks.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedTempoMarks
 title: "Tempo"
-version: "dev"
+version: "v4"
 ---
 
 Tempo marks are indications through words, abbreviations, or specific metronome settings of the speed at which a piece of music is to be performed. Both instantaneous and continuous tempo markings may be encoded using this element.

_guidelines-dev/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/03-shareddynamics.md → _guidelines-v4/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/03-shareddynamics.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedDynamics
 title: "Dynamics"
-version: "dev"
+version: "v4"
 ---
 
 Dynamics, or dynamic marks, are terms, abbreviations, and symbols that indicate the specific degrees of volume of a note, phrase, or section of music, e.g., "piano", "forte". Transitions from one volume level to another, e.g., "crescendo", "diminuendo", are also specified through dynamic marks.

_guidelines-dev/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/04-sharedphrasemarks.md → _guidelines-v4/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/04-sharedphrasemarks.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedPhraseMarks
 title: "Phrase Marks"
-version: "dev"
+version: "v4"
 ---
 
 Phrase marks are curved lines placed over or under notes to delineate short sections of a work that represent a unified melodic idea, analogous to a phrase in literature.

_guidelines-dev/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/05-sharedornaments.md → _guidelines-v4/01-shared/02-sharedmusicalelements/05-sharedexpressionmarks/05-sharedornaments.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedOrnaments
 title: "Ornaments"
-version: "dev"
+version: "v4"
 ---
 
 Ornaments are formulae of embellishment that can be realized by adding supplementary notes to one or more notes of the melody.

_guidelines-dev/01-shared/03-sharedtextualelements.md → _guidelines-v4/01-shared/03-sharedtextualelements.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedTextualElements
 title: "Shared Textual Elements"
-version: "dev"
+version: "v4"
 ---
 
 This section lists elements declared in the shared module that pertain to the encoding of prose.

_guidelines-dev/01-shared/03-sharedtextualelements/01-sharedparagraphs.md → _guidelines-v4/01-shared/03-sharedtextualelements/01-sharedparagraphs.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedParagraphs
 title: "Paragraphs"
-version: "dev"
+version: "v4"
 ---
 
 A paragraph is a structural unit of a larger text. Usually, it is typographically distinct; that is, it usually begins on a new line and the first letter of the content is often indented, enlarged, or both. This element has a similar meaning as the corresponding elements in Encoded Archival Description (EAD), Text Encoding Initiative (TEI), and HTML.

_guidelines-dev/01-shared/03-sharedtextualelements/02-sharedtextrendition.md → _guidelines-v4/01-shared/03-sharedtextualelements/02-sharedtextrendition.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedTextRendition
 title: "Text Rendition"
-version: "dev"
+version: "v4"
 ---
 
 Sometimes, it is desirable to capture the typographical qualities of a word or phrase without assigning it a special meaning. For this purpose, MEI offers the {% include link elem="rend" %} element, similar to TEI's *hi* element. Using CSS-like values, its **@rend** attribute can be used to specify many typographic features, such as font style, font variants, and relative font size and weight. In addition, text decoration, direction, and enclosing ‘boxes’ may be captured. While **@rend** is used to record relative font size and weight, absolute values for these qualities (measured in printers points) should be specified using the **@fontsize** and **@fontweight** attibutes. In addition to commonly found typographical qualities, MEI provides the **@altrend** attribute for the capture of additional, user-defined rendition information.

_guidelines-dev/01-shared/03-sharedtextualelements/03-sharedtitlepages.md → _guidelines-v4/01-shared/03-sharedtextualelements/03-sharedtitlepages.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedTitlePages
 title: "Transcription of Titlepages"
-version: "dev"
+version: "v4"
 ---
 
 A specialized element is furnished for the capture of titlepage information.

_guidelines-dev/01-shared/03-sharedtextualelements/04-sharednamesnumbersdates.md → _guidelines-v4/01-shared/03-sharedtextualelements/04-sharednamesnumbersdates.md

@@ -1,5 +1,5 @@
 ---
 sectionid: sharedNamesNumbersDates
 title: "Names, Dates, Numbers, Abbreviations, and Addresses"
-version: "dev"
+version: "v4"
 ---

_guidelines-dev/01-shared/03-sharedtextualelements/04-sharednamesnumbersdates/01-sharednames.md → _guidelines-v4/01-shared/03-sharedtextualelements/04-sharednamesnumbersdates/01-sharednames.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedNames
 title: "Names and Dates"
-version: "dev"
+version: "v4"
 ---
 
 The {% include link elem="name" %} and {% include link elem="date" %} elements may be used to mark up portions of a text that function as names or dates.

_guidelines-dev/01-shared/03-sharedtextualelements/04-sharednamesnumbersdates/02-sharednumbers.md → _guidelines-v4/01-shared/03-sharedtextualelements/04-sharednamesnumbersdates/02-sharednumbers.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedNumbers
 title: "Numbers"
-version: "dev"
+version: "v4"
 ---
 
 The {% include link elem="num" %} element may be used to identify any numeric information in a text. The **@unit** may be used to specify the unit of measurement.

_guidelines-dev/01-shared/03-sharedtextualelements/04-sharednamesnumbersdates/03-sharedaddresses.md → _guidelines-v4/01-shared/03-sharedtextualelements/04-sharednamesnumbersdates/03-sharedaddresses.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedAddresses
 title: "Addresses"
-version: "dev"
+version: "v4"
 ---
 
 Addresses may be encoded using the {% include link elem="address" %} element, which itself may hold an arbitrary number of {% include link elem="addrLine" %} elements.

_guidelines-dev/01-shared/03-sharedtextualelements/05-sharedannotations.md → _guidelines-v4/01-shared/03-sharedtextualelements/05-sharedannotations.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedAnnotations
 title: "Annotations"
-version: "dev"
+version: "v4"
 ---
 
 Annotations are one of the most versatile features of MEI. They are provided using the {% include link elem="annot" %} element.

_guidelines-dev/01-shared/03-sharedtextualelements/06-sharedbibliographiccitations.md → _guidelines-v4/01-shared/03-sharedtextualelements/06-sharedbibliographiccitations.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedBibliographicCitations
 title: "Bibliographic Citations and References"
-version: "dev"
+version: "v4"
 ---
 
 The following element is used in the encoding of bibliographic citations and references:

_guidelines-dev/01-shared/03-sharedtextualelements/07-sharedrelateditemdesc.md → _guidelines-v4/01-shared/03-sharedtextualelements/07-sharedrelateditemdesc.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedRelatedItemDesc
 title: "Related Items"
-version: "dev"
+version: "v4"
 ---
 
 In some situations it is necessary to provide references from one bibliographic item to another. For these situations, MEI offers the {% include link elem="relatedItem" %} element. A {% include link elem="relatedItem" %} may be used inside of {% include link elem="bibl" %}, and may either point to a different entity using its **@target** attribute, or may hold the related item as a child.

_guidelines-dev/01-shared/04-sharedcommonattributes.md → _guidelines-v4/01-shared/04-sharedcommonattributes.md

@@ -1,7 +1,7 @@
 ---
 sectionid: sharedCommonAttributes
 title: "Common Attributes"
-version: "dev"
+version: "v4"
 ---
 
 The following attributes, provided by the {% include link att="att.common" %} attribute class, are available on nearly all elements in an MEI encoding. They provide the means to identify, label, and access elements in MEI-encoded files.

_guidelines-dev/02-header.md → _guidelines-v4/02-header.md

@@ -1,7 +1,7 @@
 ---
 layout: sidebar
 sidebar: s1
-version: "dev"
+version: "v4"
 title: "The MEI Header"
 sectionid: "header"
 ---

_guidelines-dev/02-header/01-headerfiledescription.md → _guidelines-v4/02-header/01-headerfiledescription.md

@@ -1,7 +1,7 @@
 ---
 sectionid: headerFileDescription
 title: "File Description"
-version: "dev"
+version: "v4"
 ---
 
 The structure of the bibliographic description of a machine-readable or digital musical text resembles that of a book, an article, or other kinds of textual objects. The file description element of the MEI header has therefore been closely modelled on existing standards in library cataloging; it should thus provide enough information to allow users to give standard bibliographic references to the electronic text, and to allow catalogers to catalog it. Bibliographic citations occurring elsewhere in the header, and in the text itself, are derived from the same model.

_guidelines-dev/02-header/01-headerfiledescription/01-headertitlestatement.md → _guidelines-v4/02-header/01-headerfiledescription/01-headertitlestatement.md

@@ -1,7 +1,7 @@
 ---
 sectionid: headerTitleStatement
 title: "Title Statement"
-version: "dev"
+version: "v4"
 ---
 
 The {% include link elem="titleStmt" %} element is the first component of the {% include link elem="fileDesc" %} element, and is mandatory:

_guidelines-dev/02-header/01-headerfiledescription/02-headereditionstmt.md → _guidelines-v4/02-header/01-headerfiledescription/02-headereditionstmt.md

@@ -1,7 +1,7 @@
 ---
 sectionid: headerEditionstmt
 title: "Edition Statement"
-version: "dev"
+version: "v4"
 ---
 
 The {% include link elem="editionStmt" %} element is the second component of the {% include link elem="fileDesc" %} element. It is optional but recommended when applicable.

_guidelines-dev/02-header/01-headerfiledescription/03-headerphysicaldescription.md → _guidelines-v4/02-header/01-headerfiledescription/03-headerphysicaldescription.md

@@ -1,7 +1,7 @@
 ---
 sectionid: headerPhysicalDescription
 title: "Physical Description of the File"
-version: "dev"
+version: "v4"
 ---
 
 The third component of the fileDesc is a description of the physical qualities of the file. The {% include link elem="extent" %} element is provided for this purpose.

_guidelines-dev/02-header/01-headerfiledescription/04-headerpublicationdistribution.md → _guidelines-v4/02-header/01-headerfiledescription/04-headerpublicationdistribution.md

@@ -1,7 +1,7 @@
 ---
 sectionid: headerPublicationDistribution
 title: "Publication, Distribution, etc."
-version: "dev"
+version: "v4"
 ---
 
 The {% include link elem="pubStmt" %} element is the fourth component of the {% include link elem="fileDesc" %} element and is mandatory.