feat(llms): add tip callout and markdown view support (#1184)

Author: dineshpinto

docs/1-intro.mdx

@@ -127,6 +127,17 @@ Additional configuration and API resources are detailed on the [Network](/networ
 
 ## Build faster with ecosystem tools
 
+:::tip[Building with AI]
+
+To feed Developer Hub into your LLM, use these auto-generated [llms.txt](https://llmstxt.org/) files served from the site root:
+
+- `/llms-full.txt` - The entire documentation as a single text file.
+- `/llms.txt` - A concise index of all pages with titles and descriptions.
+
+For specific pages, use the **"View page as Markdown"** button at the bottom of any guide.
+
+:::
+
 <div className="row">
   <div className="col col--3 margin-bottom--lg">
     <DocCard

docusaurus.config.ts

@@ -62,7 +62,7 @@ const config: Config = {
           remarkPlugins: [remarkMath],
           rehypePlugins: [rehypeKatex],
           editUrl:
-            "https://github.com/flare-foundation/developer-hub/edit/main",
+            "https://raw.githubusercontent.com/flare-foundation/developer-hub/main",
           onInlineTags: "throw",
         },
         blog: false,

src/theme/EditThisPage/index.tsx

@@ -0,0 +1,46 @@
+import React, { type ReactNode } from "react";
+import Translate from "@docusaurus/Translate";
+import { ThemeClassNames } from "@docusaurus/theme-common";
+import Link from "@docusaurus/Link";
+import type { Props } from "@theme/EditThisPage";
+import styles from "./styles.module.css";
+
+function ExternalIcon({ className }: { className?: string }) {
+  return (
+    <svg
+      aria-hidden="true"
+      focusable="false"
+      xmlns="http://www.w3.org/2000/svg"
+      width={16}
+      height={16}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth={2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      className={className}
+    >
+      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
+      <path d="M17 7l-10 10" />
+      <path d="M8 7l9 0l0 9" />
+    </svg>
+  );
+}
+
+export default function EditThisPage({ editUrl }: Props): ReactNode {
+  return (
+    <Link
+      to={editUrl}
+      className={`${ThemeClassNames.common.editThisPage} ${styles.editThisPageLink}`}
+    >
+      <Translate
+        id="theme.common.editThisPage"
+        description="The link label to view the raw source for the current page"
+      >
+        View page as Markdown
+      </Translate>
+      <ExternalIcon className={styles.externalIcon} />
+    </Link>
+  );
+}

src/theme/EditThisPage/styles.module.css

@@ -0,0 +1,26 @@
+.editThisPageLink,
+.editThisPageLink:visited {
+  color: var(--ifm-font-color-base);
+  text-decoration: none;
+  transition: color var(--ifm-transition-fast)
+    var(--ifm-transition-timing-default);
+}
+
+.editThisPageLink:hover,
+.editThisPageLink:focus-visible {
+  color: var(--ifm-color-primary);
+  text-decoration: none;
+}
+
+[data-theme="dark"] .editThisPageLink:hover,
+[data-theme="dark"] .editThisPageLink:focus-visible {
+  color: var(--ifm-color-primary-lighter);
+}
+
+.externalIcon {
+  margin-left: 0.3em;
+  vertical-align: text-bottom;
+  stroke: currentColor;
+  transition: color var(--ifm-transition-fast)
+    var(--ifm-transition-timing-default);
+}