Documentation

Custom Components

Throughout the docs, you'll notice that we make use of custom components, in addition to the default markdown, to render special elements. An overview of these can be found below:

Rendering a Public REST API Tester

<livewire:endpoint spec="api/public-rest-api/endpoints/specs/blockchain.json" />

Rendering a Page Reference

<livewire:page-reference page="/docs/delegate-registration" />

Rendering an Embed Link

<livewire:embed-link url="https://blog.ark.io/ark-core-series-schnorrs-multisignatures-4979caac887a" caption="ARK Core - Schnorr" />

Rendering a Sidebar Link

<x-general.sidebar-link path="/docs/api/public-rest-api/getting-started" name="Getting Started" />

Rendering a Sidebar Link with Children

The root path property should represent the closest parent of the child paths.

<x-general.sidebar-link
    path="/docs/api/public-rest-api/endpoints"
    name="Endpoints"
    :children="[
        ['path' => '/docs/api/public-rest-api/endpoints/blockchain', 'name' => 'Blockchain'],
        ['path' => '/docs/api/public-rest-api/endpoints/blocks', 'name' => 'Blocks'],
        ['path' => '/docs/api/public-rest-api/endpoints/delegates', 'name' => 'Delegates'],
        ['path' => '/docs/api/public-rest-api/endpoints/node', 'name' => 'Node'],
        ['path' => '/docs/api/public-rest-api/endpoints/peers', 'name' => 'Peers'],
        ['path' => '/docs/api/public-rest-api/endpoints/transactions', 'name' => 'Transactions'],
        ['path' => '/docs/api/public-rest-api/endpoints/votes', 'name' => 'Votes'],
        ['path' => '/docs/api/public-rest-api/endpoints/wallets', 'name' => 'Wallets'],
    ]"
/>

Rendering an Alert

Type can be info, success, warning or danger.

<x-alert type="info">
Hello World!
</x-alert>

Rendering a Link Collection

<x-link-collection
    :links="[
        ['path' => '/docs/core/services/attributes', 'name' => 'Attributes'],
        ['path' => '/docs/core/services/cache', 'name' => 'Cache'],
        ['path' => '/docs/core/services/events', 'name' => 'Events'],
        ['path' => '/docs/core/services/filesystem', 'name' => 'Filesystem'],
        ['path' => '/docs/core/services/logging', 'name' => 'Logging'],
        ['path' => '/docs/core/services/mixins', 'name' => 'Mixins'],
        ['path' => '/docs/core/services/pipeline', 'name' => 'Pipeline'],
        ['path' => '/docs/core/services/queue', 'name' => 'Queue'],
        ['path' => '/docs/core/services/schedule', 'name' => 'Schedule'],
        ['path' => '/docs/core/services/triggers', 'name' => 'Triggers'],
        ['path' => '/docs/core/services/validation', 'name' => 'Validation'],
    ]"
/>

Tutorial Intro Page

The tutorial intro page has specific properties you can use at the top of the document as explained below (they need to be encapsulated between the listed ---)

---
title: <text>
excerpt: <text>
excerpt_long: <text>
is_featured: <true/false>
learn_about: <text>
learn_topics:
- <list of topics>
assets: <path to assets directory>
---

Please note that the assets directory expects to hold 3 images called featured.svg, banner.svg and image.svg as these are used on the various tutorial pages.

Documentation Pages

Documentation pages have a title property that is used for example used for the navigation at the bottom of the pages.

---
title: <text>
---

Security

If you discover a security vulnerability within this package, please send an e-mail to security@ark.io. All security vulnerabilities will be promptly addressed.

Credits

This project exists thanks to all the people who contribute.

JuanmanDev/docs