Files
xrpl-dev-portal/dactyl-config.yml
2018-05-09 12:35:00 -07:00

917 lines
30 KiB
YAML

# 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
blurb: Common conventions used across the rippled API.
funnel: Docs
doc_type: References
supercategory: rippled API
category: API Conventions
template: template-landing-children.html
targets:
- local
- md: references/rippled-api/api-conventions/basic-data-types.md
html: basic-data-types.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: API Conventions
targets:
- local
- 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
- md: references/rippled-api/api-conventions/error-formatting.md
html: error-formatting.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: API Conventions
targets:
- local
- md: references/rippled-api/api-conventions/markers-and-pagination.md
html: markers-and-pagination.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: API Conventions
targets:
- local
- md: references/rippled-api/api-conventions/modifying-the-ledger.md
html: modifying-the-ledger.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: API Conventions
targets:
- local
- md: references/rippled-api/api-conventions/request-formatting.md
html: request-formatting.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: API Conventions
targets:
- local
- md: references/rippled-api/api-conventions/rippled-server-states.md
html: rippled-server-states.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: API Conventions
targets:
- local
# rippled Public Methods
- 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
targets:
- local
- name: Ledger Header #TODO: break off from ledger-format-old-monolith.md file
html: ledger-header.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: Ledger Data Formats
targets:
- local
- name: Ledger Object Types #TODO: break off from ledger-format-old-monolith.md file
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
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
targets:
- local
# TODO: 10 other ledger object types
- 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