config.yml

# The Brooklyn Rail / Editing Workflow
# https://brooklynrail.org/workflow

# ====================================
display_url: https://brooklynrail.org/events
site_url: https://brooklynrail.org

# logo_url — sets the logo in the admin
logo_url: https://brooklynrail.org/images/dist/brooklynrail-logo-red.png

# ====================================
# Account settings
backend:
  name: git-gateway
  repo: brooklynrail/brooklynrail-platform
  site_domain: brooklynrail.netlify.com
  base_url: https://api.netlify.com
  # branch: master

# ====================================
# Workflow -- NetlifyCMS editorial workflow tools
# publish_mode: editorial_workflow
open_authoring: false # accept contributions (forks) from GitHub users
# branch: master
squash_merges: true # squash all commits into a single commit when the PR is merged
commit_messages:
  create: 'New {{collection}}: "{{slug}}"'
  update: 'Update {{collection}} "{{slug}}"'
  delete: 'Delete {{collection}} "{{slug}}"'
  uploadMedia: 'Upload "{{path}}"'
  deleteMedia: 'Delete "{{path}}"'
  openAuthoring: "{{message}}, {{author-login}}"

# ====================================
# Media
# Where media will be stored in the repo
media_folder: "/static/media/files"
# Path for uploaded media on the live site
public_folder: "/media/files"

# ====================================
# Configuration
# slug — sets how filenames for entries are created and sanitized.
slug:
  encoding: "unicode"
  clean_accents: true

# Localhost Editing
# uses the local proxy server port set in the `netlify dev` command
local_backend:
  url: http://localhost:8081/api/v1

#local_backend: false
# Note: no matter where you access Netlify CMS — whether running locally, in a staging environment, or in your published site — it will always fetch and commit files in your hosted repository (for example, on GitHub), on the branch you configured in your Netlify CMS config.yml file. This means that content fetched in the admin UI will match the content in the repository, which may be different from your locally running site. It also means that content saved using the admin UI will save directly to the hosted repository, even if you're running the UI locally or in staging. If you want to have your local CMS write to a local repository, try the local_backend setting, currently in beta.
# https://www.netlifycms.org/docs/configuration-options/#backend

# ====================================
# Collections
collections:
  # ====================================
  # Events
  - name: "events" # Used in routes, e.g., /workflow/collections/blog
    label: "Events" # Used in the UI
    label_singular: "Event"
    description: "All events on Brooklynrail.org"
    folder: "content/events" # path to the folder where files are stored
    path: "{{year}}/{{month}}/{{slug}}" # custom file path
    create: true # Allow users to create new documents in this collection
    identifier_field: title # sets the field that is used to create the slug
    slug: "{{slug}}"
    summary: "{{fields.series}} {{title}} ({{year}}-{{month}}-{{day}})"
    editor:
      preview: false

    fields: # The fields for each document, usually in frontmatter
      - label: "Event Title"
        name: "title"
        minimal: true
        widget: "string"
        hint: "Keep it short and topical, no acronyms."

      - label: "Deck"
        name: "deck"
        minimal: true
        widget: "string"
        hint: "A continuation of the headline, without repeating it. Think of this as the sentence you'd most like to tweet. You need to be able to read it outloud in a single breath."
        required: false

      - label: "Summary"
        name: "summary"
        minimal: true
        widget: "string"
        default: ""
        hint: "One-sentence description of the event. (e.g. Artist [Name] and writer [Name] discuss creative life in the context of our new social reality.)"

      - label: "Event Copy"
        name: "body"
        widget: "markdown"
        editor_components: ["image"]
        required: false

      - label: "People"
        name: "people"
        widget: "list"
        required: false
        fields:
          - label: "Person"
            name: "person"
            minimal: true
            widget: "string"
            hint: "[See all people »](https://brooklynrail.org/people/)"
            required: false
          - label: "Related Links"
            name: "related_links"
            widget: "list"
            hint: "add no more than three related links for this author"
            required: false
            fields:
              - label: "Link Text"
                name: "text"
                widget: "string"
                hint: "Add a clear headline ot title. Do not include the name of the site you're linking to."
              - label: "Link"
                name: "url"
                widget: "string"
                hint: "Add the full URL of the link (e.g. https://brooklynrail.org/2020/05/example)"

      - label: "Poets"
        name: "poets"
        widget: "list"
        required: false
        fields:
          - label: "Person"
            name: "person"
            minimal: true
            widget: "string"
            hint: "[See all people »](https://brooklynrail.org/people/)"
            required: false
          - label: "Related Links"
            name: "related_links"
            widget: "list"
            hint: "example"
            required: false
            fields:
              - label: "Link Text"
                name: "text"
                widget: "string"
                hint: "Use a clear title or headline"
              - label: "Link"
                name: "url"
                widget: "string"
                hint: "e.g https://brooklynrail.org/2020/06/editorsmessage/The-Mirror-Displaced-Artists-Writing-on-Art"

      - label: "Start time"
        name: "date"
        widget: "datetime"
        date_format: "YYYY-MM-DD" # e.g. 2021-11.23
        time_format: "HH:mm" # e.g. 21:00
        format: "YYYY-MM-DDTHH:mm:00-0500"
        hint: "The start date and time of the event (Note: uses a 24hr clock, e.g. 13:00)"

      - label: "End time"
        name: "end_date"
        widget: "datetime"
        date_format: "YYYY-MM-DD" # e.g. 2021-11.23
        time_format: "HH:mm" # e.g. 21:00
        format: "YYYY-MM-DDTHH:mm:00-0500"
        hint: "The end date and time of the event (Note: uses a 24hr clock, e.g. 14:00)"

      - label: "Series number"
        name: "series"
        widget: "number"
        value_type: "int"
        required: false

      - label: "Collections"
        name: "collections"
        widget: "select"
        options: ["the-new-social-environment", "common-ground", "rail-events", "sponsored-listing", "screening", "endowment", "community-listing"]
        multiple: true
        collection: "collections"
        default: ["the-new-social-environment"]
        hint: "The collections this event should be included in."
        required: false

      - label: "Event Sponsor"
        name: "event_sponsor"
        widget: "select"
        options: ["the-new-social-environment", "common-ground", "rail-events", "sponsored-listing", "screening", "endowment", "community-listing"]
        multiple: true
        collection: "organizations"
        hint: "The organizations sponsoring this event. This should not be 'The Brooklyn Rail'."
        required: false

      - label: "Event Organizer"
        name: "event_organizer"
        widget: "select"
        multiple: true
        collection: "organizations"
        options: ["the-brooklyn-rail"]
        default: ["the-brooklyn-rail"]
        hint: "Default 'the-brooklyn-rail'."
        required: false

      - label: "Event Producer"
        name: "event_producer"
        widget: "select"
        multiple: true
        collection: "organizations"
        options: ["the-brooklyn-rail"]
        default: ["the-brooklyn-rail"]
        hint: "Default 'the-brooklyn-rail'."

      - label: "YouTube ID"
        name: "youtube_id"
        widget: "string"
        hint: "The YouTube ID is the string of characters between the `v=` and the `&` in the video URL. (e.g. `3FKyVeipMss`)"
        required: false

      - label: "AirTable ID"
        name: "event_id"
        widget: "string"
        hint: "The unique registration ID from the Events Airtable (e.g. `recbhJng4Fq6cVbW2`)"
        required: false

      - label: "Registration URL"
        name: "registration_url"
        widget: "string"
        hint: "A link to a registration form. When used, this overrides our airtable registration form. Both cannot be present at the same time (e.g. https://www.eventbrite.com/...)"
        required: false

      - label: "Event Platform"
        name: "event_platform"
        widget: "select"
        multiple: true
        options: ["zoom", "youtube", "instagram_live", "igtv"]
        hint: "Zoom, youtube, instagram_live, igtv"
        default: ["zoom"]
        required: false

      - label: "Event Platform URL"
        name: "event_platform_url"
        widget: "string"
        hint: "Enter the URL where people can join"
        required: false

      - label: "Sold out"
        name: "soldout"
        widget: "boolean"
        default: false
        required: false

      - label: "Redirects"
        name: "aliases"
        widget: "list"
        hint: "Enter the path(s) that will break when you change the title of the page or the URL. They will redirect to the new URL. Separate multiple paths with commas [e.g. /events/2020/06/19/example, /events/2020/06/19/example-title ]"
        required: false

  # ====================================
  # Pages
  - name: "pages" # Used in routes, e.g., /workflow/collections/blog
    label: "Pages" # Used in the UI
    label_singular: "Page"
    description: "TKTK"
    folder: "content/pages" # path to the folder where files are stored
    # path: "{{slug}}" # custom file path
    create: true # Allow users to create new documents in this collection
    identifier_field: title # sets the field that is used to create the slug
    slug: "{{slug}}"
    summary: "{{title}}"

    fields: # The fields for each document, usually in frontmatter
      - label: "Page Title"
        name: "title"
        widget: "string"
        hint: "This is the page title that will appear in search and across the internet. Super important to make this short and topical. [e.g. Board Members]"

      - label: "Headline"
        name: "headline"
        widget: "string"
        hint: "This is headline that will appear on the page. It might be the same as the page title, but has the freedom to be a little more playful. [e.g. Our Wonderful Board Members]"

      - label: "Page nav title"
        name: "nav_title"
        widget: "string"
        required: false
        hint: ""

      - label: "Deck"
        name: "deck"
        minimal: true
        widget: "string"
        hint: "A continuation of the headline, without repeating it. Think of this as the sentence you'd most like to tweet. You need to be able to read it outloud in a single breath."
        required: false

      - label: "Summary"
        name: "summary"
        minimal: true
        widget: "string"
        default: ""
        hint: "One-sentence description of the page. Try not to repeat the headline."

      - label: "Body"
        name: "body"
        widget: "markdown"
        editor_components: ["image", "donate"]

      - label: "Weight"
        name: "weight"
        widget: "number"
        default: 1
        value_type: "int"
        min: 0
        max: 100
        step: 1
        hint: "Pages are ordered by weight, starting with 1. Weight `0` hides a page from the page nav."

  # ====================================
  # Media

  - name: "media" # Used in routes, e.g., /workflow/collections/blog
    label: "Media" # Used in the UI
    label_singular: "Media"
    description: "TKTK"
    folder: "content/media" # path to the folder where files are stored
    media_folder: "/{{media_folder}}"
    public_folder: "/media/files"
    path: "{{year}}/{{month}}/{{slug}}"
    extension: "md"
    create: true # Allow users to create new documents in this collection
    identifier_field: title # sets the field that is used to create the slug
    slug: "{{title}}"
    summary: "{{title}} ({{year}}-{{month}})"
    editor:
      preview: false

    fields: # The fields for each document, usually in frontmatter
      - label: "Media"
        name: "media"
        widget: "image"
        hint: ""
        prompt: true
        required: false
        media_library:
          config:
            multiple: true

      - label: "Image title"
        name: "title"
        widget: "string"
        hint: "A descriptive title for the image"

      - label: "Image Alt"
        name: "alt"
        hint: "A drawing of artist [NAME] by Phong Bui."

      - label: "Image Caption"
        name: "caption"
        widget: "string"
        required: false

      # - label: "Image Credit"
      #   name: "credit"
      #   widget: "relation"
      #   multiple: true
      #   collection: "people"
      #   search_fields: ["name"]
      #   value_field: "{{slug}}"
      #   display_fields: ["{{name}}"]
      #   hint: "This is the person who will receive credit as the author of the image."
      #   required: false

      - label: "Date"
        name: "date"
        widget: "datetime"
        date_format: "YYYY-MM-DD" # e.g. 24.12.2021
        time_format: "HH:mm" # e.g. 21:07
        format: "YYYY-MM-DDTHH:mm:00-0500"

  # ====================================
  # Collections
  # NOTE: the word "collection" is being used in the RAIL site as a replacement for section. It is also a word to describe a grouping of content in Netlify CMS. In this case, the specific name of the collection is 'collections'.

  - name: "collections" # Used in routes, e.g., /workflow/collections/blog
    label: "Collections" # Used in the UI
    label_singular: "Collection"
    description: "A group of similar content."
    folder: "content/collections" # path to the folder where files are stored
    path: "{{slug}}" # custom file path
    create: true # Allow users to create new documents in this collection
    identifier_field: title # sets the field that is used to create the slug
    slug: "{{slug}}"

    fields: # The fields for each document, usually in frontmatter
      - label: "Title"
        name: "title"
        widget: "string"
        hint: "TKTK"

      - label: "Deck"
        name: "deck"
        widget: "string"
        hint: "TKTK"
        required: false

      - label: "Summary"
        name: "summary"
        widget: "string"
        hint: "A short description of this collection"
        required: false

      - label: "YouTube Playlist ID"
        name: "youtube_playlist_id"
        widget: "string"
        hint: "TKTK"
        required: false

      - label: "Sponsor"
        name: "sponsor"
        widget: "string"
        multiple: true
        collection: "organizations"
        # search_fields: ["name", "short_desc"]
        # value_field: "{{slug}}"
        # display_fields: ["{{name}}"]
        hint: "The organizations sponsoring this collection. This should not be 'The Brooklyn Rail'."
        required: false

  # ====================================
  # People

  - name: "people" # Used in routes, e.g., /workflow/collections/blog
    label: "People" # Used in the UI
    label_singular: "Person"
    description: "People in the Rail community"
    folder: "content/people" # path to the folder where files are stored
    path: "{{slug}}" # custom file path
    create: true # Allow users to create new documents in this collection
    identifier_field: name # sets the field that is used to create the slug
    slug: "{{slug}}"
    editor:
      preview: false

    fields: # The fields for each document, usually in frontmatter
      - label: "Display Name"
        name: "name"
        widget: "string"
        hint: "This is how the person's name will appear in bylines, credits, and other listings. [e.g. Phong H. Bui]"

      - label: "First Name"
        name: "first_name"
        widget: "string"
        hint: "Please enter the person's first name, or closest approximation. This name should be how you'd address them if you were sending them an email. [e.g. Phong]"

      - label: "Last Name"
        name: "last_name"
        widget: "string"
        hint: "Please enter the person's last name, or closest approximation. [e.g. Bui]"
        required: false

      - label: "Pronouns"
        name: "pronouns"
        widget: "string"
        hint: "List the pronoun(s) for this person, only if they've provided them to you. They will be displayed alongside their name. Learn more at http://mypronouns.org"
        required: false

      - label: "Short Bio"
        name: "short_bio"
        widget: "text"
        pattern: ["^.{0,800}$", "Short bio needs to be less than 800 characters (~120 words)"]
        hint: "Add a short description of the person without using their name. [Max 800 characters (~120 words)]"
        required: false

      - label: "Portrait Images"
        name: "portraits"
        widget: "list"
        hint: "These are portraits of this person."
        required: false
        fields:
          - label: "Media"
            name: "media"
            minimal: true
            widget: "string"
            hint: "[See all Media »](https://brooklynrail.org/media/)"
            required: false

      - label: "Email"
        name: "email"
        widget: "string"
        hint: "Example `info@kasmingallery.com`"
        required: false

      - label: "Relationship"
        name: "relationship"
        widget: "select"
        multiple: true
        options:
          [
            "donor",
            "board-member",
            "advisory-board",
            "staff",
            "publisher",
            "section-editor",
            "consulting-editor",
            "editor-at-large",
            "alumni",
          ]
        hint: "Donor, Board Member, Advisory Board, Staff, Alumni"
        required: false

      - label: "Job Title"
        name: "job_title"
        widget: "string"
        hint: "Example `Managing Director`"
        required: false

      - label: "Rail Contributor URL"
        name: "rail_contributor_url"
        widget: "string"
        hint: "Fastest way to find the page is to Google for `AUTHOR NAME Brooklyn Rail` and then enter the URL here (e.g. https://brooklynrail.org/contributor/tom-mcglynn)"
        required: false

      - label: "Website"
        name: "website"
        widget: "string"
        hint: "Enter the full URL of the organization website. Example: `https://kasmingallery.com/`"
        required: false

      - label: "Instagram"
        name: "instagram"
        widget: "string"
        hint: "Enter the username without the @ handle [e.g. brooklynrail]"
        required: false

      - label: "Twitter"
        name: "twitter"
        widget: "string"
        hint: "Enter the username without the @ handle [e.g. brooklynrail]"
        required: false

      - label: "Linkedin"
        name: "linkedIn"
        widget: "string"
        required: false

  # ====================================
  # Organizations

  - name: "organizations" # Used in routes, e.g., /workflow/collections/blog
    label: "Organizations" # Used in the UI
    label_singular: "Organization"
    description: "Organizations in the Rail community"
    folder: "content/organizations" # path to the folder where files are stored
    path: "{{slug}}" # custom file path
    create: true # Allow users to create new documents in this collection
    identifier_field: name # sets the field that is used to create the slug
    slug: "{{slug}}"
    editor:
      preview: false

    fields: # The fields for each document, usually in frontmatter
      - label: "Organization Name"
        name: "name"
        widget: "string"
        hint: "TKTK"

      - label: "Short description"
        name: "short_desc"
        widget: "text"
        pattern: ["^.{0,240}$", "Short bio needs to be less than 240 characters"]
        hint: "Add a short description of the organization without using their name. [Max 240 characters]"
        required: false

      - label: "Primary Email"
        name: "email"
        widget: "string"
        hint: "Example: `info@kasmingallery.com`"
        required: false

      - label: "Website"
        name: "website"
        widget: "string"
        hint: "Enter the full URL of the organization website. Example: `http://kasmingallery.com/`"
        required: false

      - label: "Instagram"
        name: "instagram"
        widget: "string"
        hint: "Enter the username without the @ handle [e.g. brooklynrail]"
        required: false

      - label: "Twitter"
        name: "twitter"
        widget: "string"
        hint: "Enter the username without the @ handle [e.g. brooklynrail]"
        required: false

      - label: "Relationship"
        name: "relationship"
        widget: "select"
        multiple: true
        options:
          [
            "featured-donor",
            "donor",
            "board-member",
            "advisory-board",
            "staff",
            "publisher",
            "section-editor",
            "consulting-editor",
            "editor-at-large",
            "alumni",
          ]
        hint: "Donor, Board Member, Advisory Board, Staff, Alumni"
        required: false