Merge 9ac470b109 into 865d8cc80f

astro.config.mjs

@@ -1,6 +1,7 @@
 import { defineConfig } from 'astro/config';
 import codeblocks from "@thewebforge/astro-code-blocks";
 import preload from "astro-preload";
+import * as config from './src/config.js';
 
 import mdx from "@astrojs/mdx";
 
@@ -11,5 +12,6 @@ export default defineConfig({
     // Copy Button Options
     copyButtonTitle: 'Copy',
     copyButtonTooltip: 'Copied to clipboard',
-}), mdx()]
+  }), mdx()],
+  redirects: config.REDIRECTS,
 });

src/components/APIArguments.astro

@@ -0,0 +1,61 @@
+---
+const {args} = Astro.props;
+---
+
+{(args && args.length) ? (
+    <h3>Arguments</h3>
+    <table class="arguments">
+        <tbody>
+            {args.map(arg=>(
+                <tr class="argument">
+                    <th>
+                        <strong>{arg.name}</strong>
+                        <br/>
+                        <span>
+                            {!arg.is_required && (
+                                "optional "
+                            )}
+                            {arg.type}
+                        </span>
+                    </th>
+                    <th>
+                        <span>{arg.description}</span>
+                    </th>
+                </tr>
+        ))}
+        </tbody>
+    </table>
+) : ''}
+<style>
+    .arguments {
+            border: 1px solid var(--tertiary-background);
+        }
+
+        .arguments .left, .arguments .right {
+            display: flex;
+            flex-direction: column;
+        }
+
+        .arguments .argument {
+            background-color: var(--tertiary-background);
+            border-bottom: 1px solid var(--tertiary-background);
+        }
+
+        .arguments .argument th {
+            text-align: left;
+            padding: 0.25rem 1rem;
+        }
+
+        .arguments .argument span {
+            text-align: left;
+            font-weight: normal;
+        }
+
+        .arguments .argument .left, .arguments .argument .right {
+            padding: 0.5rem 1rem;
+        }
+
+        .arguments .argument:nth-child(2n) {
+            background-color: var(--secondary-background);
+        }
+</style>

src/components/APIExamples.astro

@@ -0,0 +1,71 @@
+---
+import { Code } from "astro/components";
+
+const {examples, cmd} = Astro.props;
+
+if (!examples) return;
+
+// Treat title and output as metadata and remove from examples
+const title = examples.title;
+const output = examples.output;
+delete examples.title;
+delete examples.output;
+
+function setExample(example, cmd){
+                console.log(example, cmd);
+                document.body.classList.toggle(example);
+            }
+
+---
+
+<div class="examples">
+    {examples ? (
+        <div>
+            <h3>Examples</h3>
+            <h4>{title}</h4>
+            {Object.keys(examples).map(example=>(
+                <button data-example={example}>{example}</button>
+            ))}
+            {Object.keys(examples).map(example=>(
+                <div class:list={["example", cmd, example]}>
+                    <p>{example}</p>
+                    <Code lang={"bash"} code={`${examples[example]}`} />
+                </div>
+            ))}
+        </div>
+        <script define:vars={{examples, cmd}}>
+            
+            document.querySelectorAll(`.${cmd} button`).forEach(btn=>{
+                btn.addEventListener('click', (e)=>{
+                    Object.keys(examples).map(example=>{
+                        document.body.classList.remove(example);
+                    });
+                    document.body.classList.add(btn.getAttribute('data-example'));
+                })
+            })
+            
+        </script>
+    ) : ''}
+</div>
+<style>
+    .example {
+        display: none;
+    }
+
+    body:not(.curl, .lbrynet, .python) .examples .example:first-of-type {
+        display: block;
+    }
+
+    body.curl .example.curl {
+        display: block;
+    }
+
+    body.lbrynet .example.lbrynet {
+        display: block;
+    }
+
+    body.python .example.python {
+        display: block;
+    }
+
+</style>

src/components/Header.astro

@@ -8,6 +8,7 @@ const links = [
   { name: "Overview", href: "/overview" },
   { name: "Playground", href: "/playground" },
   { name: "Resources", href: "/resources"},
+  { name: "API", href: "/api"},
   { name: "Tutorials", href: "/tutorials"},
   { name: "Community", href: "/community"}
 ]

src/config.js

@@ -1,6 +1,7 @@
 export const AWESOME_LBRY = "https://github.com/LBRYFoundation/Awesome-LBRY";
 export const EDIT_PAGE = "Edit this page";
 export const REPOSITORY = "LBRYFoundation/lbry-tech";
+export const GITHUB_ORG = "LBRYFoundation";
 
 export const features = [
     {
@@ -68,4 +69,28 @@ export const featured = [
     title: "Podcatcher",
     description: "Audio media crawler for lbry."
   }
-]
+]
+
+export const REDIRECTS = {
+  // "/api/blockchain": "/api/lbrycrd",
+  // "/api/lbry": "/api/sdk",
+  // "/api/protocol": "/api/sdk",
+  // "/play": "/playground",
+  // "/repository-standards": "/resources/repository-standards",
+  // "/resources/lbry-claimtrie": "/spec#claimtrie",
+  // "/resources/schema": "/spec#metadata",
+  // "/resources/signing-claim": "/resources/claim-signing",
+  // "/resources/uri": "/spec#urls",
+  // "/resources/video-lbryandroid": "https://odysee.com/video-2018-10-15053403:e",
+  // "/resources/video-lbrycrd": "https://odysee.com/intro-to-LBRYcrd:5",
+  // "/resources/video-lbrydesktop": "https://odysee.com/LBRYAppDesign:7",
+  // "/resources/video-lbrysdk": "https://odysee.com/@lbrytech:1/lbrynet-dev-setup:9",
+  // "/specification": "/spec",
+  // "/tour": "/playground",
+  // "/whitepaper": "/spec"
+}
+
+export const API_REPOS = {
+  "lbry-sdk": "docs/api.json",
+  "lbrycrd": "contrib/devtools/generated/api_v1.json"
+}

src/pages/api.astro

@@ -0,0 +1,19 @@
+---
+import Layout from '../layouts/Layout.astro';
+
+import * as config from "../config.js";
+
+---
+
+
+<Layout title="API">
+    <div class="wrapper">
+        <ul>
+            {Object.keys(config.API_REPOS).map(repo=>(
+                <li>
+                    <a href={`/api/${repo}`}>{repo}</a>
+                </li>
+            ))}
+        </ul>
+    </div>
+</Layout>

src/pages/api/[repo].astro

@@ -0,0 +1,188 @@
+---
+import Layout from '../../layouts/Layout.astro';
+import TableOfContents from '../../components/TableOfContents.astro';
+import APIArguments from '../../components/APIArguments.astro';
+import APIExamples from '../../components/APIExamples.astro';
+
+import * as config from "../../config.js";
+import { Code } from 'astro:components';
+
+export function getStaticPaths() {
+    
+    const paths = Object.keys(config.API_REPOS).map(repo=>{
+        return {params: {repo}};
+    });
+
+    return paths; 
+}
+
+const { repo } = Astro.params;
+
+const tags = (await (await fetch(`https://data.jsdelivr.com/v1/packages/gh/${config.GITHUB_ORG}/${repo}`)).json()).versions;
+tags.unshift({version: "master"});
+
+const tag = tags[0];
+
+let docs = (await (await fetch(`https://cdn.jsdelivr.net/gh/${config.GITHUB_ORG}/${repo}@${tag.version}/${config.API_REPOS[repo]}`)).json());
+
+
+// Convert lbrycrd docs to the same structure as lbry-sdk
+if (repo === 'lbrycrd') {
+    const crd = {};
+    for (let i in docs) {
+        if (!crd[docs[i].namespace]) crd[docs[i].namespace] = {
+            doc: docs[i].namespace,
+            commands: []
+        };
+        crd[docs[i].namespace].commands.push(docs[i]);
+        console.log(docs[i]);
+        
+        //docs.main[i].command = docs.main[i].name;
+    }
+    docs = crd;
+}
+
+const headings: Array<object> = [];
+
+// Generate headings
+Object.keys(docs).forEach(group=>{
+    headings.push({
+        slug: group,
+        text: group.charAt(0).toUpperCase() + group.substr(1).toLowerCase(),
+        depth: 2
+    });
+
+    docs[group].commands.forEach(cmd=>{
+        headings.push({
+            slug: cmd.name,
+            text: cmd.name,
+            depth: 3
+        });
+    })
+    
+});
+
+---
+
+
+<Layout title={repo}>
+    <div class="wrapper">
+        <section class="sidebar">
+            {(headings && headings.length) ? (
+                <aside id="toc">
+                    <TableOfContents headings={headings} />
+                </aside>
+            ) : ''}
+        </section>
+        
+        <!-- <TableOfContents headings={headings} /> -->
+        <select>
+            {tags.map(tag=>(
+                <option>{tag.version}</option>
+            ))}
+        </select>
+        <div class="main">
+            <h1>{repo} {tag.version}</h1>
+            <p>Methods and signatures provided by {repo} are documented below. To build, download, or run the daemon, see the project
+                <a href={`https://github.com/${config.GITHUB_ORG}/${repo}/blob/${tag.version}/README.md`}>README</a>.
+            </p>
+            <div class="commands">
+                {Object.keys(docs).map(header=>(
+                    <section>
+                        <h1 id={header}>{header}</h1>
+                        {docs[header].commands.map(cmd=>(
+                            <div class:list={["command", cmd.name]}>
+                                <h2 id={cmd.name}>{cmd.name}</h2>
+                                <p>{cmd.description}</p>
+                                <APIArguments args={cmd.arguments}/>
+                                <APIExamples cmd={cmd.name} examples={cmd.examples[0]}/>
+                                <h3>Returns</h3>
+                                <Code lang={"json"} code={`${cmd.returns || "Not available."}`} class:list={["returns"]} />
+                                </div>
+                            <hr/>
+                        ))}
+                    </section>
+                ))}
+            </div>
+        </div>
+    </div>
+    <style>
+        .wrapper {
+            padding: 1rem;
+        }
+
+        .wrapper .main {
+            /* width: calc(100vw - var(--sidebar-width)); */
+            padding-inline-end: var(--sidebar-width);
+            transition: 0.3s;
+            overflow-x: hidden;
+            max-width: 1750px;
+            width: calc(100%);
+        }
+
+        .commands {
+            display: flex;
+            flex-direction: column;
+            gap: 25px;
+        }
+
+        .commands section {
+            display: flex;
+            flex-direction: column;
+            gap: 25px;
+        }
+
+        .commands section .command {
+            display: flex;
+            flex-direction: column;
+            gap: 1em;
+        }
+
+        .wrapper #toc {
+            position: fixed;
+            width: calc(var(--sidebar-width) - 2rem);
+            height: fit-content;
+            max-height: calc(100vh - var(--nav-height)*2 - 2rem * 2);
+            inset-block: 0;
+            inset-inline-end: 2rem;
+            margin: calc(2rem + var(--nav-height)) 0;
+            // background-color: var(--secondary-background);
+            transition: 0.3s;
+            z-index: 10;
+            overflow-y: auto;
+            border-radius: 1em;
+            background-color: var(--secondary-background);
+        }
+
+        @media only screen and (max-width: 1000px) {
+            .wrapper #toc {
+                position: relative;
+                width: var(--sidebar-width);
+                max-height: unset;
+                inset-block: unset;
+                inset-inline-end: unset;
+                margin-top: 0;
+                z-index: 1;
+                background-color: transparent;
+            }
+
+            .wrapper .main {
+                padding-inline-end: unset;
+            }
+        }
+        
+    </style>
+
+    <style is:inline>
+        .commands > section pre {
+            padding: 1em;
+            border-radius: 9px;
+            max-width: 80%;
+            background-color: var(--secondary-background) !important;
+        }
+
+        .commands > section pre code span {
+            white-space: break-spaces;
+        }
+    </style>
+</Layout>