url: https://googlesheets4.tidyverse.org

template:
  package: tidytemplate
  bootstrap: 5

  includes:
    in_header: |
      <script defer data-domain="googlesheets4.tidyverse.org,all.tidyverse.org" src="https://plausible.io/js/plausible.js"></script>

development:
   mode: auto

news:
  releases:
  - text: "googlesheets4 1.0.0"
    href: https://www.tidyverse.org/blog/2021/07/googlesheets4-1-0-0/
  - text: "googlesheets4 0.2.0"
    href: https://www.tidyverse.org/blog/2020/05/googlesheets4-0-2-0/

articles:
- title: Basic reading and writing
  navbar: ~
  contents:
  - googlesheets4
  - articles/read-sheets
  - articles/write-sheets

- title: Special topics
  navbar: Special topics
  contents:
  - articles/auth
  - articles/dates-and-times
  - articles/find-identify-sheets

- title: Connections to googledrive, readxl, and reprex
  navbar: Connections to other packages
  contents:
  - articles/drive-and-sheets
  - articles/fun-with-googledrive-and-readxl
  - articles/googlesheets4-reprex

- title: Developer
  desc: Articles about package internals
  contents:
  - articles/range-specification
  - articles/function-class-names
  - articles/example-sheets
  - articles/messages-and-errors

reference:
  - title: "Reading"
    desc: >
      Import data from a Sheet into a local data frame
    contents:
    - read_sheet
    - range_speedread
    - range_read_cells
    - spread_sheet
    - cell-specification
  - title: "Writing"
    desc: >
      Write data into a Sheet
    contents:
    - write_sheet
    - gs4_create
    - sheet_append
    - range_write
    - range_flood
    - range_clear
  - title: "Data preparation"
    desc: >
      Helpers for preparing data to write into Sheets
    contents:
    - gs4_fodder
    - gs4_formula
  - title: "Metadata on Sheets"
    desc: >
      Helpers for accessing Sheets and their metadata
    contents:
    - gs4_get
    - gs4_find
    - gs4_browse
    - as_sheets_id
    - gs4_random
  - title: "Modify a Sheet"
    desc: >
      Make changes to a (spread)Sheet or to the (work)sheets it contains
    contents:
    - gs4_create
    - range_delete
    - starts_with("sheet")
  - title: "Formatting and aesthetics"
    desc: >
      Change how a Sheet appears in the browser UI
    contents:
    - range_autofit
  - title: "Example Sheets"
    desc: >
      World-readable Sheets to use in examples and reprexes
    contents:
    - starts_with("gs4_example")
  - title: "Auth"
    desc: >
      Take explicit control of the googlesheets4 auth status or examine current state
    contents:
    - gs4_auth
    - gs4_deauth
    - gs4_user
    - gs4_auth_configure
    - googlesheets4-configuration
  - title: "Programming around the Sheets API"
    desc: >
      Low-level functions used internally and made available for programming
    contents:
    - request_generate
    - request_make
    - gs4_token
    - gs4_has_token
    - gs4_endpoints
    - matches("quiet")
  - title: "Operate on (spread)Sheets or the Sheets API"
    desc: >
      Functions that operate at the level of a (spread)sheet or the whole API/package
    contents:
    - starts_with("gs4_")
  - title: "Operate on (work)sheets"
    desc: >
      Functions that operate on whole (work)sheets
    contents:
    - starts_with("sheet_")
  - title: "Operate on a range of cells"
    desc: >
      Functions that can target a cell range
    contents:
    - starts_with("range_")
