metanorma-taste 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c526c9f410e607e4e5e8d2762a5b579c2daf1b3d1eda8b9206fe53a81cdc975
-  data.tar.gz: afa5c3d412d33e17d771dc4f92c605328d62a2268477f71d53fdc65a1e66d364
+  metadata.gz: dac3951f0ecd001d25c14c8dd038a0791003678a4aebc43b7219039a6baa9f53
+  data.tar.gz: b29b383bd4b5c87865f34de13e5b62df26e55fc66990141745f3f86ce4a2929f
 SHA512:
-  metadata.gz: 5179c044951e81372db5d7d14915dc0345ea7dc76fb624dd48a5d2f4a5e3de74eb90eb0712e8d9db7fb959478049eac7dae6ea297b67d17ee633d9b0391ad71f
-  data.tar.gz: 473502639257573b2a5376fc607d3ece135fb2d38edb7b76ea31824a41c5e13e725854c5f9b17aaf062c8b2b18000dc6bc21dc9ea25ebc68e04d1ac0a25b9214
+  metadata.gz: 89c8094961e1a59fd64ea25fca6bdf86243fe8fbac756fda96e3e62828098f5956d37fbe20bc9089787adff3f6d2918f4814c9be17a8bda353c156001bf3a163
+  data.tar.gz: ce5d4346fcd89bda667022ef984d2b93be8c49aeedf7adc4f5447e3f87fb4e5a33f35c12fead17a31da08ecd79fccd33e2a9af0e09282f872d04ace5942e07e4

data/Gemfile

@@ -1,18 +1,13 @@
+Encoding.default_external = Encoding::UTF_8
+Encoding.default_internal = Encoding::UTF_8
+
 source "https://rubygems.org"
+git_source(:github) { |repo| "https://github.com/#{repo}" }
 
 gemspec
 
-gem "debug"
-gem "equivalent-xml", "~> 0.6"
-gem "metanorma"
-gem "metanorma-iso"
-gem "mnconvert"
-gem "pry"
-gem "rake", "~> 13.0"
-gem "rspec", "~> 3.0"
-gem "rspec-command", "~> 1.0"
-gem "rubocop", "~> 1"
-gem "rubocop-performance"
-gem "sassc-embedded", "~> 1"
-gem "simplecov", "~> 0.15"
-gem "xml-c14n"
+begin
+  eval_gemfile("Gemfile.devel")
+rescue StandardError
+  nil
+end

data/README.adoc

@@ -152,18 +152,37 @@ currently available:
 |`icc`
 |International Color Consortium
 |`iso`
-|ICC specifications and standards with ICC branding and copyright
+|International Color Consortium specifications and standards with ICC branding and copyright
 
 |`elf`
 |Express Language Foundation
 |`iso`
-|ELF specifications and standards with ELF branding and copyright
+|Express Language Foundation specifications and standards with ELF branding and copyright
 
 |`enosema`
 |Enosema Foundation
 |`iso`
 |Enosema specifications and standards with Enosema branding and copyright
 
+|`csa`
+|Cloud Security Alliance
+|`generic`
+|Cloud Security Alliance specifications and standards with CSA branding and copyright
+
+|`pdfa`
+|PDF Association
+|`ribose`
+|PDF Association specifications and standards with PDFA branding and copyright
+
+|`swf`
+|Spatial Web Foundation
+|`ribose`
+|Spatial Web Foundation specifications and standards with SWF branding and copyright
+
+|`mbxif`
+|MBx Interoperability Forum
+|`ribose`
+|MBx Interoperability Forum specifications and standards with MBx-IF branding and copyright
 |===
 
 
@@ -216,14 +235,36 @@ The main configuration file for each taste:
 flavor: string             # The name of the custom flavor (e.g., "icc")
 owner: string              # Organization name (e.g., "International Color Consortium")
 base-flavor: string        # Base Metanorma flavor to extend (e.g., "iso")
-copyright-notice: string   # Path to boilerplate file (e.g., "copyright.adoc"), which includes
-                           # copyright, license, legal, and feedback notices
-i18n-dictionary: string    # Path to internationalization dictionary (e.g., "i18n.yaml")
-publisher-logo: string     # Path to publisher logo (e.g., "icc.png")
-base-override:             # Hash of document attributes to override from base flavor
-  publisher: string        # Publisher name override
-  publisher_abbr: string   # Publisher abbreviation
-  presentation-metadata-*: # Template style attributes for presentation
+base-override:             # Document attributes to override from base flavor
+  filename-attributes:     # Metanorma document attributes that contain filenames
+    copyright-notice: string   # Path to boilerplate file (e.g., "copyright.adoc")
+    i18n-dictionary: string    # Path to internationalization dictionary (e.g., "i18n.yaml")
+    publisher-logo: string     # Path to publisher logo (e.g., "icc.png")
+    htmlcoverpage: string      # HTML output cover page
+    htmlintropage: string      # HTML output introductory page
+    htmlstylesheet: string     # HTML output CSS stylesheet
+    htmlstylesheet-override: string     # HTML output CSS stylesheet, overriding base flavor stylesheet
+    wordcoverpage: string      # Word output cover page
+    wordintropage: string      # Word output introductory page
+    wordstylesheet: string     # Word output CSS stylesheet
+    wordstylesheet-override: string     # Word output CSS stylesheet, overriding base flavor stylesheet
+    standardstylesheet: string # Word output secondary CSS stylesheet
+    standardstylesheet-override: string # Word output secondary CSS stylesheet, overriding base flavor stylesheet
+    header: string             # Word output header and footer content
+    pdf-stylesheet: string     # PDF output XSLT stylesheet
+    pdf-stylesheet-override: string     # PDF output XSLT stylesheet, overriding base flavor stylesheet
+    customize: string          # Path to custom metanorma configuration file
+    coverpage-image: string    # Path to coverpage image file
+    backpage-image: string     # Path to backpage image file
+  value-attributes:        # Metanorma document attributes that contain values
+    publisher: string        # Publisher name override
+    publisher_abbr: string   # Publisher abbreviation
+    body-font: string        # Default font to use in HTML and Word stylesheets
+    header-font: string      # Header font to use in HTML and Word stylesheets
+    monospace-font: string   # Monospace font to use in HTML and Word stylesheets
+    fonts: string            # Comma-delimited listing of fonts to retrieve for the taste from Fontist
+    output-extensions: string         # Comma-delimited listing of output formats to support (subset of base flavor's)
+    presentation-metadata-*: # Template style attributes for presentation
 doctypes:                  # Array of doctypes built over base flavour doctypes
   - taste:                 # taste-specific machine-readable doctype name
     base:                  # Base Metanorma flavor corresponding machine-readable doctype name
@@ -238,13 +279,21 @@ doctypes:                  # Array of doctypes built over base flavour doctypes
 flavor: icc
 owner: International Color Consortium
 base-flavor: iso
-copyright-notice: copyright.adoc
-i18n-dictionary: i18n.yaml
 base-override:
-  publisher: International Color Consortium
-  publisher_abbr: ICC
-  presentation-metadata-color-secondary: '#376795'
-  presentation-metadata-backcover-text: color.org
+  filename-attributes:
+    copyright-notice: copyright.adoc
+    i18n-dictionary: i18n.yaml
+    publisher-logo: icc-full.svg
+    htmlcoverpage: htmlcoverpage.html
+    htmlstylesheet-override: htmlstylesheet-override.scss
+  value-attributes:
+    publisher: International Color Consortium
+    publisher_abbr: ICC
+    presentation-metadata-color-secondary: '#376795'
+    presentation-metadata-backcover-text: color.org
+    body-font: Arial, 'Helvetica Neue', Helvetica, sans-serif
+    header-font: Arial, 'Helvetica Neue', Helvetica, sans-serif
+    output-extensions: xml,html,pdf,doc
 doctypes:
 - taste: specification # Specification # The name goes into i18n.yaml
   base: international-standard
@@ -320,24 +369,48 @@ on the metaorma.org site.
 
 === Base-Override configuration
 
-The `base-override` section allows customization of any document attribute
-supported by the base flavor.
+The `base-override` section allows customization of document attributes
+supported by the base flavor through two nested categories:
 
-This includes:
+==== Filename Attributes (`filename-attributes`)
 
-Document attributes:
+These are Metanorma document attributes that contain filenames and file paths:
+
+* `copyright-notice`: Path to boilerplate file containing copyright, license, and legal notices
+* `i18n-dictionary`: Path to internationalization dictionary
+* `publisher-logo`: Path to organization logo file
+* `htmlcoverpage`, `htmlintropage`: HTML output page templates
+* `htmlstylesheet`, `htmlstylesheet-override`: HTML CSS stylesheets
+* `wordcoverpage`, `wordintropage`: Word output page templates  
+* `wordstylesheet`, `wordstylesheet-override`: Word CSS stylesheets
+* `standardstylesheet`, `standardstylesheet-override`: Secondary Word CSS stylesheets
+* `header`: Word output header and footer content
+* `pdf-stylesheet`, `pdf-stylesheet-override`: PDF XSLT stylesheets
+* `customize`: Path to custom metanorma configuration file
+* `coverpage-image`, `backpage-image`: Cover and back page image files
+
+==== Value Attributes (`value-attributes`)
+
+These are Metanorma document attributes that contain values (not filenames):
 
 * `publisher`: Organization name
 * `publisher_abbr`: Organization abbreviation
-* `doctype`: Document type mappings
+* `body-font`, `header-font`, `monospace-font`: Typography settings
+* `fonts`: Comma-delimited list of fonts to retrieve from Fontist
+* `output-extensions`: Comma-delimited list of supported output formats
+* `presentation-metadata-*`: Visual styling attributes for presentation, including:
+  ** `presentation-metadata-color-secondary`: Secondary color for styling
+  ** `presentation-metadata-backcover-text`: Text for document back cover
+  ** `presentation-metadata-ul-label-list`: Unordered list label formatting
+  ** `presentation-metadata-annex-delim`: Annex delimiter formatting
+  ** `presentation-metadata-middle-title`: Middle title formatting
+  ** `presentation-metadata-ol-label-template-alphabet`: Ordered list alphabet template
+  ** `presentation-metadata-ol-label-template-alphabet_upper`: Ordered list uppercase alphabet template
+  ** `presentation-metadata-ol-label-template-roman`: Ordered list roman numeral template
+  ** `presentation-metadata-ol-label-template-roman_upper`: Ordered list uppercase roman numeral template
+  ** `presentation-metadata-ol-label-template-arabic`: Ordered list arabic numeral template
 * Custom organization-specific attributes
 
-Template style attributes:
-
-* `presentation-metadata-*`: Visual styling attributes
-* Color schemes, logos, layout preferences
-* Typography and formatting options
-
 The availability of these attributes depends on the base flavor's supported
 document attributes and template system.
 
@@ -346,6 +419,15 @@ For example, the ISO flavor supports specific presentation metadata attributes.
 Other flavors may have different customization options. Please check the base
 flavor documentation for available attributes.
 
+== Mappings of structures from taste to base flavours
+
+The taste configuration includes various document classifications which need to be
+mapped between values specific to the taste, and corresponding values in the base flavor.
+The document will actually be compiled with the base flavor settings, but it will be
+rendered using the taste's corresponding values. These includes
+
+* `doctype`: mapping of taste doctypes to native base flavor doctypes
+* `stage`: mapping of taste stages to native base flavor stages
 
 == Data model
 

data/data/csa/boilerplate.adoc

@@ -0,0 +1,35 @@
+== copyright-statement
+=== {blank}
+© {{ docyear }} Cloud Security Alliance, LLC.
+
+{% if unpublished %}
+== license-statement
+=== Warning for Drafts
+
+This document is not a CSA Standard. It is distributed for review and
+comment, and is subject to change without notice and may not be referred to as
+a Standard. Recipients of this draft are invited to submit, with their
+comments, notification of any relevant patent rights of which they are aware
+and to provide supporting documentation.
+{% endif %}
+
+== legal-statement
+=== {blank}
+All rights reserved. Unless otherwise specified, no part of this
+publication may be reproduced or utilized otherwise in any form or by any
+means, electronic or mechanical, including photocopying, or posting on the
+internet or an intranet, without prior written permission. Permission can
+be requested from the address below.
+
+== feedback-statement
+=== {blank}
+Cloud Security Alliance
+
+[align="left"]
+2212 Queen Anne Ave N +
+Seattle +
+WA 98109 +
+United States of America +
+ +
+copyright@cloudsecurityalliance.com +
+https://www.cloudsecurityalliance.com[www.cloudsecurityalliance.com]

data/data/csa/config.yaml

@@ -0,0 +1,63 @@
+---
+flavor: csa
+owner: Cloud Security Alliance
+base-flavor: generic
+base-override:
+  filename-attributes:
+    customize: metanorma.yml
+    copyright-notice: boilerplate.adoc
+    i18n-dictionary: i18n.yaml
+    publisher-logo: logo.svg
+    htmlcoverpage: html_csa_titlepage.html
+    htmlstylesheet: htmlstyle.scss
+    htmlintropage: html_csa_intro.html
+    wordcoverpage: word_csa_titlepage.html
+    standardstylesheet: csa.scss
+    wordstylesheet: wordstyle.scss
+    wordintropage: word_csa_intro.html
+    header: header.html
+    pdf-stylesheet: csa.standard.xsl
+  value-attributes:
+    publisher: Cloud Security Alliance
+    publisher_abbr: CSA
+    body-font: Lato,"Source Sans Pro",sans-serif
+    header-font: Lato,"Source Sans Pro",sans-serif
+    monospace-font: '"Source Code Pro",monospace'
+    presentation-metadata-ul-label-list: "•, -, o"
+    presentation_metadata_annex_delim: "<br/>"
+    presentation_metadata_middle_title: ""
+    presentation_metadata_ol_label_template_alphabet_upper: "%<span class='fmt-label-delim'>)</span>"
+    output-extensions: xml,html,pdf,doc
+doctypes:
+- taste: standard
+  base: standard
+- taste: guidance
+  base: guide
+- taste: proposal
+  base: standard
+- taste: report
+  base: report
+- taste: whitepaper
+  base: specification
+- taste: charter
+  base: directive
+- taste: policy
+  base: admministrative
+- taste: glossary
+  base: specification
+- taste: case-study
+  base: report
+stages:
+  proposal:
+  working-draft:
+    abbreviation: wd
+  committee-draft:
+    abbreviation: cd
+  draft-standard:
+    abbreviation: d
+  final-draft:
+  published:
+    default: true
+    published: true
+  withdrawn:
+    published: true