ChapterIntro

Markdown

The structured front matter of an intro chapter (set_chapter_intro): a cover with kicker, title and byline, then up to 20 sections. Strings are trimmed and empty ones dropped; the whole object is at most 150,000 characters of JSON. Photos are storageIds the intro owns: a write that drops one deletes the file (for a live guide, at the next publish).

Fields

  • coverKickerstringoptional

    The cover's eyebrow line, at most 120 characters (A Patagonia Field Guide).

  • coverTitlestringoptional

    The cover title, at most 160 characters. Absent means the guide's name.

  • coverAuthorstringoptional

    The byline name, shown as By <name>, at most 120 characters. Absent means the creator's display name.

  • coverAuthorPhotoStorageIdstring · stored file idoptional

    The byline photo, a storageId from an upload with target=blob. Absent means the creator's avatar.

  • sectionsarray of IntroSectionrequired

    Up to 20 sections in reading order.

    Show 9 fieldsof IntroSection
    • kindstringoptional

      prose (the default), chapters (a row for each other chapter of the guide) or collections (a card for each collection that has spots). The rows and cards derive from the guide; items only restyle them.

      prosechapterscollections
    • kickerstringoptional

      The eyebrow above the title, at most 120 characters.

    • titlestringrequired

      The section title, at most 160 characters. Required.

    • deckstringoptional

      The standfirst under the title, at most 500 characters.

    • paragraphsarray of stringsoptional

      Prose sections only: up to 30 paragraphs of at most 10,000 characters. Lines starting with "- " inside a paragraph render as a bulleted list.

    • cellsarray of objectsoptional

      Prose sections only: up to 8 numbered cells (a plan in steps). A section with cells carries no paragraphs and no photo.

      Show 2 fields
      • titlestringrequired

        The cell's title, at most 120 characters. Required unless the whole cell is empty, which drops it.

      • bodystringrequired

        The cell's text, at most 600 characters.

    • photoStorageIdstring · stored file idoptional

      Prose sections only: the side photo, a storageId from an upload with target=blob.

    • photoCreditstringoptional

      The side photo's credit, at most 80 characters, shown on the photo. Kept only with a photo; absent means the creator's own shot.

    • itemsarray of IntroItemoptional

      Chapters and collections sections only: up to 60 entries, each restyling one row or card.

      Show 6 fieldsof IntroItem
      • collectionIdstring · chapter idrequired

        The chapter (chapters section) or plain collection (collections section) of this guide the entry dresses, once per section.

      • titlestringoptional

        The name on the row or card, at most 120 characters. Absent means the chapter's or collection's name.

      • linestringoptional

        Chapters sections only: the short line under the name, at most 200 characters. Absent means the chapter's description.

      • colorstringoptional

        Chapters sections only: the row's color bar as #rrggbb (stored lower case).

      • photoStorageIdstring · stored file idoptional

        Collections sections only: the card photo, a storageId from an upload with target=blob. Absent means the collection's cover.

      • photoCreditstringoptional

        The card photo's credit, at most 80 characters. Kept only with a photo.

Used by