xrpl-dev-portal/dactyl-config.yml

# Relative paths work OK as long as you start the tool from its local dir
template_path: tool

# This folder gets copied into the output directory
template_static_path: assets

# Templates should have filenames starting in template-
default_template: template-doc.html
default_pdf_template: template-forpdf.html

# HTML, PDF, GFM all get output here
out_path: out

# MD files should be here (and in subdirs)
content_path: content

# This folder gets copied into the output directory
content_static_path: img

# PDF creation needs a dir for temporary files
temporary_files_path: /tmp/

default_filters:
    - multicode_tabs
    - standardize_header_ids
    - buttonize
    - callouts
    - badges
    - link_replacement

callout_class: "devportal-callout"

cover_page:
    name: Overview
    html: index.html
    template: template-home.html
    sidebar: disabled

targets:
    # First member is the default that gets built when target not specified
    -   name: local
        display_name: XRP Ledger Dev Portal
        # These github_ fields are used by the template's "Edit on GitHub" link.
        #  Override them with --vars to change which fork/branch to edit.
        github_forkurl: https://github.com/mDuo13/ripple-dev-portal
        github_branch: 5layertest
        recently_updated:
            - html: introduction.html
              date: 2018-05-07
            # - html: capacity-planning.html
            #   date: 2018-05-04
            - html: reliable-transaction-submission.html
              date: 2018-04-16

pages:

    -   name: Docs
        funnel: Docs
        template: template-landing-docs.html
        html: docs.html
        sidebar: disabled
        targets:
            - local

# Concepts ---------------------------------------------------------------------

    -   name: Concepts
        funnel: Docs
        doc_type: Concepts
        html: concepts.html
        template: template-landing-children.html
        blurb: Learn the "what" and "why" behind fundamental aspects of the XRP Ledger.
        targets:
            - local

    -   name: Introduction
        funnel: Docs
        doc_type: Concepts
        category: Introduction
        html: introduction.html
        template: template-landing-children.html
        blurb: The XRP Ledger is a decentralized cryptographic ledger powered by a network of peer-to-peer rippled servers. This section covers basic concepts that help you learn the "what" and "why" behind fundamental aspects of the XRP Ledger.
        targets:
            - local

    -   md: concepts/introduction/xrp-ledger-overview.md
        html: xrp-ledger-overview.html
        funnel: Docs
        doc_type: Concepts
        category: Introduction
        blurb: Get a quick and concise introduction to key features of the XRP Ledger.
        targets:
            - local

        #TODO: DOC-1503: replace this with a more concise intro to consensus
    -   md: concepts/introduction/consensus.md
        html: consensus.html
        funnel: Docs
        doc_type: Concepts
        category: Introduction
        blurb: Understand the role of consensus in the XRP Ledger.
        targets:
            - local

    -   md: concepts/introduction/xrp.md
        html: xrp.html
        funnel: Docs
        doc_type: Concepts
        category: Introduction
        blurb: Learn about the uses and properties of XRP, the digital asset for payments.
        targets:
            - local

    -   name: Payment System Basics
        html: payment-system-basics.html
        funnel: Docs
        doc_type: Concepts
        category: Payment System Basics
        template: template-landing-children.html
        blurb: One of the primary purposes of the XRP Ledger is payment processing. Learn more about key concepts that will help you understand the XRP Ledger payment system.
        targets:
            - local

    -   md: concepts/payment-system-basics/accounts/accounts.md
        html: accounts.html
        funnel: Docs
        doc_type: Concepts
        category: Payment System Basics
        subcategory: Accounts
        blurb: Learn about accounts in the XRP Ledger. Accounts can send transactions and hold XRP.
        targets:
            - local

    -   md: concepts/payment-system-basics/accounts/cryptographic-keys.md
        html: cryptographic-keys.html
        funnel: Docs
        doc_type: Concepts
        category: Payment System Basics
        subcategory: Accounts
        blurb: Use cryptographic keys to approve transactions so the XRP Ledger can execute them.
        targets:
            - local

    # TODO: multi-signing, depositauth, reserves

    -   md: concepts/payment-system-basics/fees.md
        html: fees.html
        funnel: Docs
        doc_type: Concepts
        category: Payment System Basics
        blurb: Learn about the types of fees allowed by the XRP Ledger, including neutral fees (payable to no one) that protect the ledger against abuse, as well as fees that users can collect from each other.
        targets:
            - local

    -   md: concepts/payment-system-basics/transaction-cost.md
        html: transaction-cost.html
        funnel: Docs
        doc_type: Concepts
        category: Payment System Basics
        blurb: The transaction cost is a small amount of XRP destroyed to send a transaction, which protects the ledger from spam. Learn how the transaction cost applies.
        targets:
            - local

    # TODO: "Source and Destination Tags" stand-alone document

    -   name: Complex Payment Types
        html: complex-payment-types.html
        funnel: Docs
        doc_type: Concepts
        category: Complex Payment Types
        template: template-landing-children.html
        blurb: In addition to simple point-to-point XRP Payments, the XRP Ledger supports a number of complex payment types for a variety of use cases and situations.
        targets:
            - local

    -   md: concepts/complex-payment-types/checks.md
        html: checks.html
        funnel: Docs
        doc_type: Concepts
        category: Complex Payment Types
        blurb: Checks let users to create deferred payments that can be canceled or cashed by the intended recipients.
        targets:
            - local

    -   md: concepts/complex-payment-types/escrow.md
        html: escrow.html
        funnel: Docs
        doc_type: Concepts
        category: Complex Payment Types
        blurb: Escrows set aside XRP and deliver it later when certain conditions are met. Escrows can depend on time limits, cryptographic conditions, or both.
        targets:
            - local

    -   md: concepts/complex-payment-types/partial-payments.md
        html: partial-payments.html
        funnel: Docs
        doc_type: Concepts
        category: Complex Payment Types
        blurb: Partial payments subtract fees from the amount sent, delivering a flexible amount. Partial payments are useful for returning unwanted payments without incurring additional costs.
        targets:
            - local

    # TODO: payment channels concept

    -   md: concepts/issued-currencies/issued-currencies.md
        html: issued-currencies.html
        funnel: Docs
        doc_type: Concepts
        category: Issued Currencies
        template: template-landing-children.html
        blurb: All currencies other than XRP can be represented in the XRP Ledger as issued currencies. Learn more about how issued currencies function in the XRP Ledger.
        targets:
            - local

    # TODO: "Trust Lines and Issuing" (see gateway guide, tx reference on "trust limits" etc.)

    -   md: concepts/issued-currencies/authorized-trust-lines.md
        html: authorized-trust-lines.html
        funnel: Docs
        doc_type: Concepts
        category: Issued Currencies
        targets:
            - local

    # TODO: Freezes, Rippling, Transfer Fees, Paths, Demurrage

    -   md: concepts/decentralized-exchange/decentralized-exchange.md
        html: decentralized-exchange.html
        funnel: Docs
        doc_type: Concepts
        category: Decentralized Exchange
        template: template-landing-children.html
        blurb: The XRP Ledger contains a fully-functional exchange where users can trade issued currencies for XRP or each other.
        targets:
            - local

    # TODO: Offers, Tick Size, Autobridging, Offer Preference (all compiled from different sources)

    -   md: concepts/consensus-network/consensus-network.md
        html: consensus-network.html
        funnel: Docs
        doc_type: Concepts
        category: Consensus Network
        template: template-landing-children.html
        blurb: The XRP Ledger uses a consensus algorithm to resolve the double spend problem and choose which transactions to execute in which order. Consensus also governs rules of transaction processing.
        targets:
            - local

    # TODO: consensus principles & rules, validators & UNLs

    -   md: concepts/consensus-network/amendments.md
        html: amendments.html
        funnel: Docs
        doc_type: Concepts
        category: Consensus Network
        blurb: Amendments represent new features or other changes to transaction processing. Validators coordinate through consensus to apply these upgrades to the XRP Ledger in an orderly fashion.
        targets:
            - local

    # TODO: fee voting, consensus research, pseudo-transactions, parallel networks

    -   md: concepts/the-rippled-server/the-rippled-server.md
        html: the-rippled-server.html
        funnel: Docs
        doc_type: Concepts
        category: The rippled Server
        blurb: rippled is the core peer-to-peer server that manages the XRP Ledger. This section covers concepts that help you learn the "what" and "why" behind fundamental aspects of the rippled server.
        targets:
            - local

    # TODO: history sharding, stand-alone mode, clustering, peer protocol

# Tutorials --------------------------------------------------------------------

    -   md: tutorials/tutorials.md
        html: tutorials.html
        funnel: Docs
        doc_type: Tutorials
        template: template-landing-children.html
        blurb: Get step-by-step guidance to perform common tasks with the XRP Ledger.
        targets:
            - local

    -   md: tutorials/get-started/get-started.md
        html: get-started.html
        funnel: Docs
        doc_type: Tutorials
        category: Get Started
        template: template-landing-children.html
        targets:
            - local

    # TODO: Get Started with the rippled API, Send a Transaction with the rippled API

    -   md: tutorials/get-started/get-started-with-rippleapi-for-javascript.md
        html: get-started-with-rippleapi-for-javascript.html
        funnel: Docs
        doc_type: Tutorials
        category: Get Started
        targets:
            - local

    # TODO: Get Started with API Tools

    -   md: tutorials/use-simple-xrp-payments/use-simple-xrp-payments.md
        html: use-simple-xrp-payments.html
        funnel: Docs
        doc_type: Tutorials
        category: Use Simple XRP Payments
        template: template-landing-children.html
        targets:
            - local

    # TODO: "Send XRP"

    -   md: tutorials/use-simple-xrp-payments/reliable-transaction-submission.md
        html: reliable-transaction-submission.html
        funnel: Docs
        doc_type: Tutorials
        category: Use Simple XRP Payments
        targets:
            - local

    # TODO: Cancel or Skip a Transaction, Look Up Transaction Results

    -   md: tutorials/manage-account-settings/manage-account-settings.md
        html: manage-account-settings.html
        funnel: Docs
        doc_type: Tutorials
        category: Manage Account Settings
        template: template-landing-children.html
        targets:
            - local

    # TODO: "Get an Account", "Configure a Regular Key Pair", "Use Deposit Authorization to Block Unwanted Payments", "Configure Multi-Signing"

    -   md: tutorials/use-complex-payment-types/use-complex-payment-types.md
        html: use-complex-payment-types.html
        funnel: Docs
        doc_type: Tutorials
        category: Use Complex Payment Types
        template: template-landing-children.html
        targets:
            - local

    # TODO: split up "use escrows"

    #TODO: split concept info off of the paychan tutorial
    -   md: tutorials/use-complex-payment-types/use-payment-channels.md
        html: use-payment-channels.html
        funnel: Docs
        doc_type: Tutorials
        category: Use Complex Payment Types
        targets:
            - local

    -   md: tutorials/use-complex-payment-types/use-checks/use-checks.md
        html: use-checks.html
        funnel: Docs
        doc_type: Tutorials
        category: Use Complex Payment Types
        subcategory: Use Checks
        template: template-landing-children.html
        targets:
            - local

    -   md: tutorials/use-complex-payment-types/use-checks/send-a-check.md
        html: send-a-check.html
        funnel: Docs
        doc_type: Tutorials
        category: Use Complex Payment Types
        subcategory: Use Checks
        targets:
            - local

    # TODO: other 5 checks tutorials

    # TODO: "Send a Cross-Currency Payment"

    -   md: tutorials/manage-issued-currencies/manage-issued-currencies.md
        html: manage-issued-currencies.html
        funnel: Docs
        doc_type: Tutorials
        category: Manage Issued Currencies
        template: template-landing-children.html
        targets:
            - local

    # TODO: Set up issuing/operational addresses, monitor changes to balances,
    # freeze, enable/disable rippling, set transfer fees, use auth'd trust lines

    -   md: tutorials/xrp-ledger-businesses/xrp-ledger-businesses.md
        html: xrp-ledger-businesses.html
        funnel: Docs
        doc_type: Tutorials
        category: XRP Ledger Businesses
        template: template-landing-children.html
        targets:
            - local

    # TODO: list XRP as an exchange, become a gateway
    # TODO: identify your accounts with ripple.txt (to come later)

    -   md: tutorials/manage-the-rippled-server/manage-the-rippled-server.md
        html: manage-the-rippled-server.html
        funnel: Docs
        doc_type: Tutorials
        category: Manage the rippled Server
        template: template-landing-children.html
        targets:
            - local

    # TODO: install rippled, troubleshoot rippled, build & run on ubuntu,
    #  run a validator, run in stand-alone mode, set up private peers, run in
    #  a cluster, capacity planning

# References -------------------------------------------------------------------

    -   name: References
        funnel: Docs
        doc_type: References
        template: template-landing-references.html
        html: references.html
        sidebar: disabled
        blurb: Look up the ins-and-outs of XRP Ledger APIs, including sample requests and responses.
        targets:
            - local

    # rippled API --------------------------------------------------------------

    -   md: references/rippled-api/rippled-api.md
        html: rippled-api.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        template: template-landing-children.html
        blurb: Use the rippled API to communicate with a rippled server, the core peer-to-peer server that manages the XRP Ledger.
        targets:
            - local

    -   md: references/rippled-api/api-conventions/api-conventions.md
        html: api-conventions.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: API Conventions
        template: template-landing-children.html
        targets:
            - local

    # TODO: Basic Data Types, Ripple Epoch Time

    -   md: references/rippled-api/api-conventions/currency-formatting.md
        html: currency-formatting.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: API Conventions
        targets:
            - local

    # TODO: rippled Server States, Error Formatting

    -   md: references/rippled-api/public-rippled-methods/public-rippled-methods.md
        html: public-rippled-methods.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        blurb: Get data from the XRP Ledger and submit transactions using these public API methods.
        template: template-landing-children.html
        targets:
            - local

    -   name: Account Methods #TODO: possible md landing content?
        html: account-methods.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Account Methods
        template: template-landing-children.html
        targets:
            - local

    -   md: references/rippled-api/public-rippled-methods/account-methods/account_channels.md
        html: account_channels.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Account Methods
        targets:
            - local

    # TODO: 8 other account methods

    -   name: Ledger Methods #TODO: possible md landing content?
        html: ledger-methods.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Ledger Methods
        template: template-landing-children.html
        targets:
            - local

    -   md: references/rippled-api/public-rippled-methods/ledger-methods/ledger.md
        html: ledger.html # Watch carefully for clashes w/ this filename
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Ledger Methods
        targets:
            - local

    # TODO: 5 other ledger methods

    -   name: Transaction Methods #TODO: possible md landing content?
        html: transaction-methods.html # watch for clashes w/ this filename
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Transaction Methods
        template: template-landing-children.html
        targets:
            - local

    -   md: references/rippled-api/public-rippled-methods/transaction-methods/sign.md
        html: sign.html # watch for clashes w/ this filename
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Transaction Methods
        targets:
            - local

    # TODO: 6 other transaction methods

    -   name: Path and Order Book Methods #TODO: possible md landing content?
        html: path-and-order-book-methods.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Path and Order Book Methods
        template: template-landing-children.html
        targets:
            - local

    -   md: references/rippled-api/public-rippled-methods/path-and-order-book-methods/book_offers.md
        html: book_offers.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Path and Order Book Methods
        targets:
            - local

    # TODO: 2 other Path and Order Book methods

    # TODO: subcategory landings and method pages for:
    # - Payment Channel Methods (2)
    # - Subscription Methods (2)
    # - Server Info Methods (3)
    # - Utility Methods (3)

    -   md: references/rippled-api/admin-rippled-methods/admin-rippled-methods.md
        html: admin-rippled-methods.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Admin rippled Methods
        blurb: Administer a rippled server with these admin API methods.
        template: template-landing-children.html
        targets:
            - local

    -   name: Key Generation Methods #TODO: possible md landing content?
        html: key-generation-methods.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Key Generation Methods
        template: template-landing-children.html
        targets:
            - local

    -   md: references/rippled-api/admin-rippled-methods/key-generation-methods/validation_create.md
        html: validation_create.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Public rippled Methods
        subcategory: Key Generation Methods
        targets:
            - local

    # TODO: Subcategory landings and pages for:
    # - Logging and Data Management Methods (5)
    # - Server Control Methods (4)
    # - Status and Debugging Messages (8)

    -   md: references/rippled-api/ledger-data-formats/ledger-data-formats.md
        html: ledger-data-formats.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        blurb: Learn about individual data objects that comprise the XRP Ledger's shared state.
        template: template-landing-children.html #TODO: consider using the default template instead for page sidebar?
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-header.md
        html: ledger-header.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        blurb: A unique header that describes the contents of a ledger version.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/ledger-object-types.md
        html: ledger-object-types.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        template: template-landing-children.html #TODO: consider dropping the md since the page children handles this OK
        blurb: Specifications for the types of objects that can be stored in a ledger's state tree.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/accountroot.md
        html: accountroot.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: The settings, XRP balance, and other metadata for one account.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/amendments.md
        html: amendments-object.html #amendments.html is taken by the concept page
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: Singleton object with status of enabled and pending amendments.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/check.md
        html: check.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: A check that can be redeemed for money by its destination.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/directorynode.md
        html: directorynode.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: Contains links to other objects.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/escrow.md
        html: escrow-object.html #escrow.html is taken by the concept page
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: Contains XRP held for a conditional payment.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/feesettings.md
        html: feesettings.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: Singleton object with consensus-approved base transaction cost and reserve requirements.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/ledgerhashes.md
        html: ledgerhashes.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: Lists of prior ledger versions' hashes for history lookup.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/offer.md
        html: offer.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: An order to make a currency trade.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/paychannel.md
        html: paychannel.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: A channel for asynchronous XRP payments.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/ripplestate.md
        html: ripplestate.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: Links two accounts, tracking the balance of one currency between them. The concept of a trust line is an abstraction of this object type.
        targets:
            - local

    -   md: references/rippled-api/ledger-data-formats/ledger-object-types/signerlist.md
        html: signerlist.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Ledger Data Formats
        subcategory: Ledger Object Types
        blurb: A list of addresses for multi-signing transactions.
        targets:
            - local

    -   md: references/rippled-api/transaction-formats/transaction-formats.md
        html: transaction-formats.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Transaction Formats
        blurb: Transactions are the only way to modify the XRP Ledger. Get details about their required format.
        template: template-landing-children.html
        targets:
            - local

    -   name: Transaction Common Fields #TODO: break off from transaction-format-old-monolith.md
        html: transaction-common-fields.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Transaction Formats
        blurb: Learn about individual data objects that comprise the XRP Ledger's shared state.
        targets:
            - local

    -   name: Transaction Types #TODO: pull landing content from transaction-format-old-monolith.md
        html: transaction-types.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Transaction Formats
        subcategory: Transaction Types
        targets:
            - local

    -   md: references/rippled-api/transaction-formats/transaction-types/accountset.md
        html: accountset.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Transaction Formats
        subcategory: Transaction Types
        targets:
            - local

    # TODO: 17 other transaction types

    -   name: Transaction Results #TODO: pull landing content from transaction-format-old-monolith.md
        html: transaction-results.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Transaction Formats
        subcategory: Transaction Results
        targets:
            - local

    -   name: tel Codes #TODO: break off content from transaction-format-old-monolith.md
        html: tel-codes.html
        funnel: Docs
        doc_type: References
        supercategory: rippled API
        category: Transaction Formats
        subcategory: Transaction Results
        targets:
            - local

    # TODO: 5 other result code classes

    # --------------- end "rippled API" section --------------------------------

    # # Temporarily commented out to make building the dev portal faster
    # -   name: RippleAPI Reference # name is required for remote-sourced files
    #     md: https://raw.githubusercontent.com/ripple/ripple-lib/0.21.0/docs/index.md
    #     html: rippleapi-reference.html
    #     funnel: Docs
    #     doc_type: References
    #     category: RippleAPI for JavaScript
    #     blurb: Official client library to the XRP Ledger. Available for JavaScript only.
    #     curated_anchors:
    #         - name: Transactions
    #           anchor: "#transaction-overview"
    #         - name: Basic Types
    #           anchor: "#basic-types"
    #         - name: Methods
    #           anchor: "#api-methods"
    #     filters:
    #         - remove_doctoc
    #         - add_version
    #     targets:
    #         - local

    # # Temporarily commented out to make building the dev portal faster
    # -   md: references/data-api.md
    #     funnel: Docs
    #     doc_type: References
    #     category: Data API
    #     blurb: Access more XRP Ledger data, including transaction history and analytics.
    #     curated_anchors:
    #         - name: Methods
    #           anchor: "#api-method-reference"
    #         - name: API Conventions
    #           anchor: "#api-conventions"
    #     targets:
    #         - local


# --------------- end "Docs" section -------------------------------------------
# Use Cases --------------------------------------------------------------------
    -   md: use-cases/use-cases.md
        html: use-cases.html
        funnel: Use Cases
        filters:
            - buttonize
        targets:
            - local

    -   md: use-cases/list-xrp-in-your-exchange.md
        html: list-xrp-in-your-exchange.html
        funnel: Use Cases
        template: template-use-case.html
        useful_background:
            - xrp-ledger-overview.html
            - reliable-transaction-submission.html
            - xrp.html
        targets:
            - local


# Dev Tools --------------------------------------------------------------------
    -   md: dev-tools/dev-tools.md
        funnel: Dev Tools
        filters:
            - buttonize
        targets:
            - local

    -   name: RPC Tool
        funnel: Dev Tools
        html: xrp-ledger-rpc-tool.html
        targets:
            - local
        template: template-xrp-ledger-rpc-tool.html

    -   name: WebSocket API Tool
        funnel: Dev Tools
        template: template-websocket-api-tool.html
        html: websocket-api-tool.html
        targets:
            - local

    -   name: Data API v2 Tool
        funnel: Dev Tools
        html: data-api-v2-tool.html
        methods_js: js/apitool-methods-data_v2.js
        rest_host: https://data.ripple.com
        doc_page: data-api.html
        sidebar: custom
        targets:
            - local
        template: template-rest-api-tool.html

    -   name: ripple.txt Validator
        funnel: Dev Tools
        html: ripple-txt-validator.html
        targets:
            - local
        template: template-ripple-txt-validator.html

    -   name: XRP Test Net Faucet
        funnel: Dev Tools
        html: xrp-test-net-faucet.html
        targets:
            - local
        template: template-test-net.html

# News -------------------------------------------------------------------------

    -   md: news/news.md
        html: news.html
        funnel: News
        targets:
            - local

    -   md: news/known-amendments.md
        html: known-amendments.html
        funnel: News
        targets:
            - local

    # Note: other "News" links (Release Notes, eventually Network Status)
    #  are external to this site


ignore_anchors_in:
    - data-api-v2-tool.html
    - websocket-api-tool.html

#Sometimes, a link is not really problematic, but the link checker detects it
# as such and the easiest solution is to ignore it.
known_broken_links:
    # Strangely, Python doesn't like the cert here. Firefox is OK with it.
    - https://validators.ripple.com

    # Login required for the client portal.
    - https://clients.ripple.com/

    # These PDFs download OK in a browser
    - http://eur-lex.europa.eu/legal-content/EN/ALL/?uri=CELEX%3A32015R0847
    - http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2006:345:0001:0009:EN:PDF

# Style Checker Config ------------------------------------------------------ #

word_substitutions_file: tool/word_substitutions.yaml
phrase_substitutions_file: tool/phrase_substitutions.yaml