{"id":367696,"date":"2026-10-07T02:31:18","date_gmt":"2026-10-07T02:31:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/nv-oos-docs-hub\/"},"modified":"2026-10-07T02:30:42","modified_gmt":"2026-10-07T02:30:42","slug":"nvoos-docs-hub","status":"publish","type":"plugin","link":"https:\/\/sa.wordpress.org\/plugins\/nvoos-docs-hub\/","author":17440330,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.5.1","stable_tag":"0.5.1","tested":"7.1.3","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"NV oOS Docs Hub","header_author":"NV Digital Solutions","header_description":"React-based documentation browser for NV oOS. Discovers, indexes, and renders Markdown docs from the base plugin and every addon in a GitBook-style SPA. Shortcode [nvoos_docs] embeds it on any page.","assets_banners_color":"e7ece0","last_updated":"2026-10-07 02:30:42","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/nvdigitalsolutions.com\/wpoos","header_author_uri":"https:\/\/nvdigitalsolutions.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":158,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.5.1":{"tag":"0.5.1","author":"vsamtani","date":"2026-10-07 02:30:42","revision":3731769}},"upgrade_notice":{"0.5.1":"

The uploads content folder moved from wp-content\/uploads\/docs\/<\/code> to wp-content\/uploads\/nvoos-docs-hub\/content\/<\/code>. Existing content is migrated automatically \u2014 no action needed.<\/p>","0.5.0":"

New local-first default: Markdown dropped into wp-content\/uploads\/docs\/<\/code> is published with zero remote calls, and GitHub import is now opt-in. Existing installs using remote repositories keep them enabled automatically. Recommended for all users.<\/p>","0.4.7":"

Compatibility release \u2014 fixes activation-time notices on WordPress 6.7+ and cleans up cron events on deactivation. Recommended for all users.<\/p>","0.4.6":"

Packaging-only release \u2014 bundles the GPLv3 license file. No functional changes.<\/p>","0.4.5":"

Security hardening release \u2014 uninstall and cache cleanup are symlink-safe. Recommended for all users.<\/p>","0.4.4":"

Security hardening release \u2014 context-source content can no longer leak through search or the sitemap. Recommended for all users.<\/p>","0.4.3":"

WordPress.org submission hardening \u2014 no functional changes for existing sites. Recommended for all users.<\/p>","0.4.2":"

Local-page links and TOC anchors now navigate inside the SPA, and broken-link fix suggestions resolve relative to the source page. Recommended for all users.<\/p>","0.4.1":"

Cache invalidation after plugin updates is fixed; the index no longer goes stale. Recommended for all users.<\/p>","0.2.0":"

Asynchronous chunked rebuilds + vendor exclusion. The "Rebuild Documentation Index" button is now non-blocking; long rebuilds run across WP-Cron ticks. Default exclusions for vendor\/<\/code> and node_modules\/<\/code> mean third-party READMEs no longer pollute your docs.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3731763,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3731763,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3731763,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3731763,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3731988,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"landingPage\":\"\\\/docs\\\/\",\"preferredVersions\":{\"php\":\"8.3\",\"wp\":\"latest\"},\"phpExtensionBundles\":[\"kitchen-sink\"],\"features\":{\"networking\":true},\"steps\":[{\"step\":\"login\",\"username\":\"admin\",\"password\":\"password\"},{\"step\":\"setSiteOptions\",\"options\":{\"blogname\":\"NV oOS Docs Hub \\u2014 Playground Demo\",\"blogdescription\":\"A live documentation site rendered from Markdown by NV oOS Docs Hub.\"}},{\"step\":\"runPHP\",\"code\":\" tag.\\n * - WordPress functions only (it runs right after wp-load).\\n * - Idempotent: guarded by the nvoos_dh_demo_seeded option.\\n *\\n * The demo is local-first and honest: ten Markdown files \\u2014 a real plugin\\n * wiki \\u2014 are written into the plugin's default local content folder\\n * (wp-content\\\/uploads\\\/nvoos-docs-hub\\\/content\\\/) and published by the\\n * synchronous rebuild in the blueprint's second runPHP step. No remote\\n * calls, no API keys, no configuration \\u2014 exactly the plugin's\\n * zero-setup workflow. The \\\/docs\\\/ page embeds ONLY the [nvoos_docs]\\n * shortcode and gets demo CSS through WordPress core Additional CSS so\\n * the docs browser fills the whole page like a standalone SPA.\\n *\\n * @package NV_oOS_Docs_Hub\\n *\\\/\\n\\nif ( ! defined( 'ABSPATH' ) ) {\\n\\texit;\\n}\\n\\n\\\/**\\n * Ensure the plugin is loaded and active before the demo code runs.\\n *\\n * The wp.org Live Preview installs the plugin WITHOUT activating it, so\\n * the seed must activate it itself \\u2014 otherwise the first reference to a\\n * plugin class fatals with \\\"Class not found\\\". The standalone demo\\n * installs with activate=true, making this a no-op there. When activation\\n * is unavailable, the plugin file is loaded directly as a fallback.\\n *\\n * @return void\\n *\\\/\\nfunction nvoos_dh_demo_ensure_plugin_active(): void {\\n\\tif ( class_exists( 'NV_oOS_Docs_Hub_Plugin' ) ) {\\n\\t\\treturn;\\n\\t}\\n\\tif ( ! function_exists( 'is_plugin_active' ) ) {\\n\\t\\trequire_once ABSPATH . 'wp-admin\\\/includes\\\/plugin.php';\\n\\t}\\n\\tif ( ! is_plugin_active( 'nvoos-docs-hub\\\/nvoos-docs-hub.php' ) ) {\\n\\t\\t$activated = activate_plugin( 'nvoos-docs-hub\\\/nvoos-docs-hub.php' );\\n\\t\\tif ( is_wp_error( $activated ) && ! class_exists( 'NV_oOS_Docs_Hub_Plugin' ) ) {\\n\\t\\t\\t$plugin_file = WP_PLUGIN_DIR . '\\\/nvoos-docs-hub\\\/nvoos-docs-hub.php';\\n\\t\\t\\tif ( file_exists( $plugin_file ) ) {\\n\\t\\t\\t\\tinclude_once $plugin_file;\\n\\t\\t\\t}\\n\\t\\t}\\n\\t}\\n}\\n\\n\\\/**\\n * The demo documentation set: filename => Markdown body.\\n *\\n * A ten-page plugin wiki. Front matter sets the nav title and sidebar\\n * order. README.md derives the `readme` slug \\u2014 the plugin's default home\\n * page \\u2014 so the docs browser opens on \\\"Getting Started\\\" out of the box.\\n * The bodies showcase GitHub Flavored Markdown (tables, task lists,\\n * fenced code) and the :::note\\\/:::tip\\\/:::warning\\\/:::danger callout\\n * blocks. External https:\\\/\\\/ links are safe from the broken-link detector\\n * (it only validates plain relative paths); no relative links are used\\n * on purpose.\\n *\\n * @return array Filename => Markdown body.\\n *\\\/\\nfunction nvoos_dh_demo_docs(): array {\\n\\treturn array(\\n\\t\\t'README.md' => <<<'MD'\\n---\\ntitle: Getting Started\\norder: 10\\n---\\n\\n# Welcome to Docs Hub\\n\\nYou are looking at **NV oOS Docs Hub** running inside WordPress Playground \\u2014\\nthis entire site, WordPress, the plugin, and every page of this wiki is\\nexecuting in your browser. Nothing was installed and nothing is sent to a\\nserver.\\n\\nDocs Hub turns plain Markdown files into a GitBook-style documentation\\nsite with sidebar navigation, a content area, and a per-page table of\\ncontents \\u2014 embedded anywhere on your WordPress site.\\n\\n## Take the tour\\n\\n| Feature | Try it |\\n|---|---|\\n| Sidebar navigation | Use the left sidebar to move between pages |\\n| Full-text search | Click the search box (or press \\u2318K \\\/ Ctrl+K) |\\n| Markdown rendering | Browse the Markdown Guide page |\\n| Callout blocks | Check the Callout Blocks page for note, tip, warning, and danger |\\n| Themes | Toggle light \\\/ dark from the toolbar |\\n\\n:::note\\nThis is what a `:::note` callout looks like. The four callout types are\\ndemonstrated on the Callout Blocks page.\\n:::\\n\\n## How this wiki was built\\n\\nTen Markdown files were dropped into\\n`wp-content\\\/uploads\\\/nvoos-docs-hub\\\/content\\\/` and one rebuild published\\nthem. No API keys. No remote calls. That is the entire pipeline.\\nMD,\\n\\t\\t'installation.md' => <<<'MD'\\n---\\ntitle: Installation\\norder: 20\\n---\\n\\n# Installation\\n\\nDocs Hub is a free plugin in the WordPress directory.\\n\\n## Install from the directory\\n\\n1. In wp-admin, open **Plugins \\u2192 Add New Plugin**.\\n2. Search for **NV oOS Docs Hub**.\\n3. Install and activate.\\n\\nThat is it. There is no setup wizard, no account, and no configuration\\nstep \\u2014 the plugin works the moment it is active.\\n\\n:::tip\\nThe plugin also ships on\\nhttps:\\\/\\\/wordpress.org\\\/plugins\\\/nvoos-docs-hub\\\/ where you can download the\\nZIP and upload it via **Plugins \\u2192 Add New Plugin \\u2192 Upload Plugin**.\\n:::\\n\\n## What activation does\\n\\nActivation creates the local content folder and schedules a nightly\\nrebuild so your documentation stays fresh without any manual step:\\n\\n```text\\nwp-content\\\/uploads\\\/nvoos-docs-hub\\\/content\\\/\\n```\\n\\nDrop Markdown files there, rebuild once, and you are publishing.\\nMD,\\n\\t\\t'local-first.md' => <<<'MD'\\n---\\ntitle: Local-First Publishing\\norder: 30\\n---\\n\\n# Local-First Publishing\\n\\nDocs Hub is local-first by default. There is no cloud, no account, and no\\nexternal service between your Markdown and your visitors.\\n\\n## The workflow\\n\\n1. Write documentation in Markdown (`.md`) or plain text (`.txt`).\\n2. Drop the files into your WordPress uploads folder.\\n3. Rebuild the index.\\n4. Embed the docs anywhere with a shortcode or block.\\n\\n```text\\nwp-content\\\/uploads\\\/nvoos-docs-hub\\\/content\\\/\\n\\u251c\\u2500\\u2500 README.md\\n\\u251c\\u2500\\u2500 installation.md\\n\\u251c\\u2500\\u2500 local-first.md\\n\\u251c\\u2500\\u2500 shortcode-block.md\\n\\u251c\\u2500\\u2500 markdown-guide.md\\n\\u251c\\u2500\\u2500 callouts.md\\n\\u251c\\u2500\\u2500 search-and-themes.md\\n\\u251c\\u2500\\u2500 github-import.md\\n\\u251c\\u2500\\u2500 wp-cli.md\\n\\u2514\\u2500\\u2500 troubleshooting.md\\n```\\n\\nSubfolders are supported \\u2014 the sidebar mirrors the folder structure.\\n\\n## Rebuilding\\n\\nFrom WP-CLI:\\n\\n```bash\\nwp nvoos-docs rebuild --sync\\n```\\n\\nFrom the admin, open **Settings \\u2192 NV oOS Docs Hub** and press\\n**Rebuild Documentation Index**. Large doc sets rebuild in chunks with a\\nlive progress panel, so a rebuild never blocks the site.\\n\\n:::tip\\nRebuilds happen on your server. Your documentation content never leaves\\nyour WordPress install unless you opt into an external source.\\n:::\\n\\n- [x] Write Markdown files\\n- [x] Drop them into the uploads content folder\\n- [x] Rebuild the index\\n- [ ] Embed `[nvoos_docs]` on any page\\nMD,\\n\\t\\t'shortcode-block.md' => <<<'MD'\\n---\\ntitle: Shortcode & Block Embeds\\norder: 40\\n---\\n\\n# Shortcode & Block Embeds\\n\\nThe docs browser embeds anywhere: a page, a post, a widget area \\u2014 via a\\nshortcode or a Gutenberg block.\\n\\n## The shortcode\\n\\n```text\\n[nvoos_docs]\\n```\\n\\nEvery option has a default, so the bare shortcode is all most sites need:\\n\\n| Attribute | Default | What it does |\\n|---|---|---|\\n| `section` | `all` | Which docs to show (`all`, or a source slug) |\\n| `theme` | `auto` | `auto` follows the visitor's preference; `light` \\\/ `dark` force one |\\n| `search` | `true` | Show the full-text search box |\\n| `sidebar` | `true` | Show the navigation sidebar |\\n| `home` | `readme` | Slug of the page shown by default |\\n\\nExample:\\n\\n```text\\n[nvoos_docs theme=\\\"dark\\\" home=\\\"getting-started\\\"]\\n```\\n\\n## The block\\n\\nIn the block editor, add the **NV oOS Docs Hub** block and pick the same\\noptions from the sidebar panel. The block and the shortcode render the\\nidentical browser.\\n\\n## Multiple embeds\\n\\nYou can place several docs browsers on the same site \\u2014 each one is an\\nindependent instance with its own state.\\nMD,\\n\\t\\t'markdown-guide.md' => <<<'MD'\\n---\\ntitle: Markdown Guide\\norder: 50\\n---\\n\\n# Markdown Guide\\n\\nDocs Hub renders GitHub Flavored Markdown \\u2014 the same dialect used by\\nGitHub, GitLab, and most developer docs.\\n\\n## Text formatting\\n\\nYou can use **bold**, *italic*, `inline code`, and ~~strikethrough~~.\\n\\n> Blockquotes render with a left border, exactly as you would expect.\\n\\n## Lists\\n\\n1. Numbered lists\\n2. Work as you expect\\n - with nested\\n - unordered items\\n\\n## Tables\\n\\n| Release | Highlight |\\n|---|---|\\n| 0.5.1 | Uploads folder renamed to the plugin slug |\\n| 0.4.7 | Cron scheduled on init; readme-only \\\"Tested up to\\\" |\\n| 0.4.4 | Staging-isolated transients + symlink-safe cleanup |\\n\\n## Task lists\\n\\n- [x] Ship a Markdown renderer\\n- [x] Support GFM tables\\n- [x] Support task lists\\n- [ ] Finish the roadmap\\n\\n## Code blocks\\n\\nFenced code blocks get syntax highlighting. A PHP example:\\n\\n```php\\nfunction greet( string $name ): string {\\n\\treturn sprintf( 'Hello, %s!', $name );\\n}\\n\\necho greet( 'Docs Hub' );\\n```\\n\\nAnd a JSON example:\\n\\n```json\\n{\\n \\\"plugin\\\": \\\"nvoos-docs-hub\\\",\\n \\\"localFirst\\\": true,\\n \\\"apiKeys\\\": 0\\n}\\n```\\nMD,\\n\\t\\t'callouts.md' => <<<'MD'\\n---\\ntitle: Callout Blocks\\norder: 60\\n---\\n\\n# Callout Blocks\\n\\nDocs Hub supports four callout types using a blockquote-style syntax. Each\\nrenders with its own icon and accent color.\\n\\n## Note\\n\\n:::note\\nUseful context the reader should see but that does not interrupt the\\nflow.\\n:::\\n\\n## Tip\\n\\n:::tip\\nA recommendation that saves time \\u2014 like pressing \\u2318K to focus the search\\nbox.\\n:::\\n\\n## Warning\\n\\n:::warning\\nSomething that can go wrong if ignored. Back up before large migrations.\\n:::\\n\\n## Danger\\n\\n:::danger\\nDestructive or irreversible. The `reset --hard` command wipes the docs\\ncache, so use it deliberately.\\n:::\\n\\n## Writing callouts\\n\\nStart a line with the callout type and a blank line ends the block:\\n\\n```markdown\\n:::warning\\nRebuilds overwrite the published docs with the current source files.\\n:::\\n```\\n\\nCallouts render in both light and dark themes, so they stay legible\\neither way.\\nMD,\\n\\t\\t'search-and-themes.md' => <<<'MD'\\n---\\ntitle: Search & Themes\\norder: 70\\n---\\n\\n# Search & Themes\\n\\n## Full-text search\\n\\nThe search box in the header searches every page of your documentation.\\n\\n- Press \\u2318K \\\/ Ctrl+K to focus search from anywhere.\\n- Matches are ranked and grouped by page.\\n- Search runs over a prebuilt index served by the REST API, with a\\n client-side fallback so it keeps working even on unusual hosts.\\n\\nTry it: search for **callout** and open the Callout Blocks page.\\n\\n## Light, dark, and auto themes\\n\\nThe toolbar theme toggle switches the docs browser between light and dark,\\nor follows your visitor's preference in `auto` mode. The choice is\\nremembered between visits.\\n\\n:::tip\\nThemes apply to the docs browser, not your whole site \\u2014 embed anywhere\\nwithout fighting the active theme's styles.\\n:::\\n\\n## Where the theme comes from\\n\\nThe docs browser ships a built-in light theme and a built-in dark theme.\\nBoth are plain CSS that can be overridden from your theme for full\\ncontrol.\\nMD,\\n\\t\\t'github-import.md' => <<<'MD'\\n---\\ntitle: GitHub Import (Opt-In)\\norder: 80\\n---\\n\\n# GitHub Import (Opt-In)\\n\\nDocs Hub can import Markdown from public GitHub repositories. The import\\nis **opt-in and off by default** \\u2014 the local Markdown workflow works with\\nzero remote calls, and this demo never enables it.\\n\\n## What it does\\n\\nWhen you add a public repository under **Settings \\u2192 NV oOS Docs Hub \\u2192\\nRemote repositories**, Docs Hub fetches the Markdown server-side and\\nindexes it alongside your local files.\\n\\n- Fetches happen only from `api.github.com` and `raw.githubusercontent.com`.\\n- No GitHub account is required.\\n- An optional personal access token only raises the API rate limits.\\n\\n:::warning\\nGitHub import is a deliberate opt-in. Leaving it off keeps Docs Hub 100%\\nlocal.\\n:::\\n\\n## Local stays first\\n\\nRemote sources are additive \\u2014 your local uploads folder remains the\\nprimary source, and anything you drop there is published on the next\\nrebuild with or without a connection.\\nMD,\\n\\t\\t'wp-cli.md' => <<<'MD'\\n---\\ntitle: WP-CLI Reference\\norder: 90\\n---\\n\\n# WP-CLI Reference\\n\\nEverything the admin UI can do is scriptable via the `nvoos-docs` command.\\n\\n## Rebuild\\n\\n```bash\\nwp nvoos-docs sync # full synchronous rebuild\\nwp nvoos-docs sync --strict # exit non-zero when broken links remain\\nwp nvoos-docs rebuild --sync # same as sync\\nwp nvoos-docs rebuild --async # chunked rebuild (default for rebuild)\\nwp nvoos-docs rebuild --resume # resume an interrupted chunked rebuild\\n```\\n\\n## Reset & clear\\n\\n```bash\\nwp nvoos-docs reset # clear a stuck rebuild state\\nwp nvoos-docs reset --hard # also wipe the live docs cache\\nwp nvoos-docs clear # clear the docs cache\\n```\\n\\n## Inspect\\n\\n```bash\\nwp nvoos-docs status # index + rebuild state\\n```\\n\\n## Automate it\\n\\nPair `wp nvoos-docs rebuild --sync` with your deployment process (rsync,\\ngit push hooks, CI) and the docs update with the same commit that changes\\nthe Markdown.\\nMD,\\n\\t\\t'troubleshooting.md' => <<<'MD'\\n---\\ntitle: Troubleshooting & FAQ\\norder: 100\\n---\\n\\n# Troubleshooting & FAQ\\n\\n## My new Markdown file is not showing\\n\\nRun a rebuild \\u2014 the index only changes when a rebuild runs.\\n\\n```bash\\nwp nvoos-docs rebuild --sync\\n```\\n\\nA nightly rebuild also runs automatically; you may just be looking before\\nit fired.\\n\\n## The rebuild seems stuck\\n\\nA chunked rebuild leaves a state record behind when it is interrupted.\\n\\n```bash\\nwp nvoos-docs reset\\nwp nvoos-docs rebuild --sync\\n```\\n\\n## Links are broken\\n\\nDocs Hub detects broken internal links and lists them with fix\\nsuggestions. Correct the relative target in the Markdown and rebuild.\\n\\n:::danger\\n`wp nvoos-docs reset --hard` wipes the live docs cache. The next rebuild\\nrepublishes it \\u2014 but run it deliberately.\\n:::\\n\\n## Does Docs Hub phone home?\\n\\nNo. Local publishing makes zero remote calls. Only the opt-in GitHub\\nimport fetches, server-side, from `api.github.com` and\\n`raw.githubusercontent.com` \\u2014 see the GitHub Import page.\\nMD,\\n\\t);\\n}\\n\\n\\\/**\\n * Markup for the published demo page that embeds the docs browser.\\n *\\n * The app is the ONLY thing on the page \\u2014 the seed also applies the\\n * no-title page template (when the theme ships one) and demo CSS via\\n * WordPress core Additional CSS so the browser fills the viewport like a\\n * standalone SPA.\\n *\\n * @return string Post content.\\n *\\\/\\nfunction nvoos_dh_demo_page_content(): string {\\n\\treturn '[nvoos_docs]';\\n}\\n\\n\\\/**\\n * Demo CSS that makes the docs browser the entire page.\\n *\\n * Written to WordPress core Additional CSS (wp_update_custom_css_post),\\n * scoped to the demo page via its body.page-id-{ID} class. Margins and\\n * paddings are zeroed explicitly across the theme's wrapper chain\\n * (site blocks, main, entry content) and the app root is forced to full\\n * width \\u2014 deliberately blunt so it survives theme template variations.\\n *\\n * @param int $page_id The published demo page ID.\\n * @return string CSS.\\n *\\\/\\nfunction nvoos_dh_demo_page_css( int $page_id ): string {\\n\\t$scope = 'body.page-id-' . $page_id;\\n\\n\\treturn '\\\/* NV oOS Docs Hub \\u2014 Playground demo: the docs browser is the whole page. *\\\/' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ',' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .wp-site-blocks,' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' main#wp--skip-link--target,' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .entry-content,' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .nvoos-docs-hub-root {' . \\\"\\\\n\\\"\\n\\t\\t. \\\"\\\\t\\\" . 'margin-left: 0 !important;' . \\\"\\\\n\\\"\\n\\t\\t. \\\"\\\\t\\\" . 'margin-right: 0 !important;' . \\\"\\\\n\\\"\\n\\t\\t. '}' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .wp-site-blocks,' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' main#wp--skip-link--target,' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .entry-content {' . \\\"\\\\n\\\"\\n\\t\\t. \\\"\\\\t\\\" . 'padding-left: 0 !important;' . \\\"\\\\n\\\"\\n\\t\\t. \\\"\\\\t\\\" . 'padding-right: 0 !important;' . \\\"\\\\n\\\"\\n\\t\\t. '}' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .wp-block-post-content,' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .nvoos-docs-hub-root {' . \\\"\\\\n\\\"\\n\\t\\t. \\\"\\\\t\\\" . 'max-width: none !important;' . \\\"\\\\n\\\"\\n\\t\\t. \\\"\\\\t\\\" . 'width: 100% !important;' . \\\"\\\\n\\\"\\n\\t\\t. '}' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .wp-site-blocks > header,' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .wp-site-blocks > footer,' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' h1.wp-block-post-title { display: none !important; }' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .wp-site-blocks { padding-top: 0 !important; padding-bottom: 0 !important; }' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' main#wp--skip-link--target { margin-top: 0 !important; }' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .nvoos-docs-hub-root { min-height: calc(100vh - 32px); }' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ':not(.admin-bar) .nvoos-docs-hub-root { min-height: 100vh; }' . \\\"\\\\n\\\"\\n\\t\\t. $scope . ' .dh-skip-link { display: none; }' . \\\"\\\\n\\\";\\n}\\n\\n\\\/**\\n * Seed the Docs Hub Playground demo. Idempotent.\\n *\\n * @return void\\n *\\\/\\nfunction nvoos_dh_demo_seed(): void {\\n\\tif ( get_option( 'nvoos_dh_demo_seeded' ) ) {\\n\\t\\treturn;\\n\\t}\\n\\n\\tnvoos_dh_demo_ensure_plugin_active();\\n\\n\\t\\\/\\\/ 1. Pretty permalinks so the \\\/docs\\\/ landing page resolves.\\n\\tglobal $wp_rewrite;\\n\\tif ( '\\\/%postname%\\\/' !== get_option( 'permalink_structure' ) ) {\\n\\t\\tif ( $wp_rewrite instanceof WP_Rewrite ) {\\n\\t\\t\\t$wp_rewrite->set_permalink_structure( '\\\/%postname%\\\/' );\\n\\t\\t} else {\\n\\t\\t\\tupdate_option( 'permalink_structure', '\\\/%postname%\\\/' );\\n\\t\\t}\\n\\t\\tflush_rewrite_rules( false );\\n\\t}\\n\\n\\t\\\/\\\/ 2. Write the demo docs into the plugin's default local content folder.\\n\\tif ( class_exists( 'NV_oOS_Docs_Hub_Plugin' ) ) {\\n\\t\\t$dir = NV_oOS_Docs_Hub_Plugin::uploads_docs_dir();\\n\\t} else {\\n\\t\\t$info = wp_upload_dir();\\n\\t\\t$dir = ( isset( $info['basedir'] ) ? (string) $info['basedir'] : '' ) . '\\\/nvoos-docs-hub\\\/content';\\n\\t}\\n\\tif ( ! is_dir( $dir ) && ! wp_mkdir_p( $dir ) ) {\\n\\t\\treturn;\\n\\t}\\n\\tforeach ( nvoos_dh_demo_docs() as $file => $markdown ) {\\n\\t\\t$path = $dir . '\\\/' . $file;\\n\\t\\tif ( ! file_exists( $path ) ) {\\n\\t\\t\\t\\\/\\\/ phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_file_put_contents -- seed-only write inside wp-content\\\/uploads.\\n\\t\\t\\tfile_put_contents( $path, $markdown );\\n\\t\\t}\\n\\t}\\n\\n\\t\\\/\\\/ 3. Publish (or converge) the demo page embedding the docs browser.\\n\\t$page = get_page_by_path( 'docs', OBJECT, 'page' );\\n\\tif ( $page instanceof WP_Post ) {\\n\\t\\t$page_id = (int) $page->ID;\\n\\t\\twp_update_post(\\n\\t\\t\\tarray(\\n\\t\\t\\t\\t'ID' => $page_id,\\n\\t\\t\\t\\t'post_title' => 'Docs Hub Demo',\\n\\t\\t\\t\\t'post_content' => nvoos_dh_demo_page_content(),\\n\\t\\t\\t\\t'post_status' => 'publish',\\n\\t\\t\\t),\\n\\t\\t\\ttrue\\n\\t\\t);\\n\\t} else {\\n\\t\\t$page_id = (int) wp_insert_post(\\n\\t\\t\\tarray(\\n\\t\\t\\t\\t'post_title' => 'Docs Hub Demo',\\n\\t\\t\\t\\t'post_name' => 'docs',\\n\\t\\t\\t\\t'post_content' => nvoos_dh_demo_page_content(),\\n\\t\\t\\t\\t'post_excerpt' => 'A live documentation wiki rendered from Markdown by NV oOS Docs Hub.',\\n\\t\\t\\t\\t'post_status' => 'publish',\\n\\t\\t\\t\\t'post_type' => 'page',\\n\\t\\t\\t),\\n\\t\\t\\ttrue\\n\\t\\t);\\n\\t}\\n\\tif ( $page_id < 1 ) {\\n\\t\\treturn;\\n\\t}\\n\\n\\t\\\/\\\/ 4. No-title template when the active theme ships one (Twenty\\n\\t\\\/\\\/ Twenty-Five+: page-no-title.html) \\u2014 the CSS below also hides the\\n\\t\\\/\\\/ title, so this is a progressive enhancement.\\n\\t$templates = glob( get_stylesheet_directory() . '\\\/templates\\\/*.html' );\\n\\t$template = '';\\n\\tif ( $templates && in_array( 'page-no-title.html', array_map( 'basename', $templates ), true ) ) {\\n\\t\\t$template = 'page-no-title.html';\\n\\t}\\n\\tupdate_post_meta( $page_id, '_wp_page_template', $template );\\n\\n\\t\\\/\\\/ 5. Full-page demo CSS via WordPress core Additional CSS.\\n\\t$css = nvoos_dh_demo_page_css( $page_id );\\n\\t$current = function_exists( 'wp_get_custom_css' ) ? (string) wp_get_custom_css() : '';\\n\\tif ( false === strpos( $current, 'Playground demo' ) ) {\\n\\t\\tif ( function_exists( 'wp_update_custom_css_post' ) ) {\\n\\t\\t\\twp_update_custom_css_post( $css );\\n\\t\\t}\\n\\t}\\n\\n\\tupdate_option( 'nvoos_dh_demo_seeded', 1 );\\n}\\nnvoos_dh_demo_seed();\"},{\"step\":\"runPHP\",\"code\":\" false, 'pages' => 0, 'error' => 'plugin-unavailable' ) );\\n\\treturn;\\n}\\n\\\/\\\/ Deterministic synchronous rebuild (the async path schedules WP-Cron\\n\\\/\\\/ ticks, which are non-deterministic inside the Playground runtime).\\ntry {\\n\\t$result = NV_oOS_Docs_Hub_Rebuild_Job::run();\\n\\t$ok = ! empty( $result['success'] );\\n\\t$pages = isset( $result['pages'] ) ? (int) $result['pages'] : 0;\\n} catch ( \\\\Exception $e ) {\\n\\t$ok = false;\\n\\t$pages = 0;\\n}\\n\\n\\\/\\\/ Keep the summary around for diagnostics (the demo page and probe read it).\\nupdate_option(\\n\\t'nvoos_dh_demo_build',\\n\\tarray(\\n\\t\\t'success' => $ok,\\n\\t\\t'pages' => $pages,\\n\\t)\\n);\"},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"nvoos-docs-hub\"},\"options\":{\"activate\":true}}]}"}},"all_blocks":[],"tagged_versions":["0.5.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3731763,"resolution":"1","location":"assets","locale":"","width":1238,"height":508},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3731763,"resolution":"2","location":"assets","locale":"","width":1008,"height":1147},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3731763,"resolution":"3","location":"assets","locale":"","width":1440,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3731763,"resolution":"4","location":"assets","locale":"","width":1440,"height":900}},"screenshots":{"1":"Settings \u2014 documentation index status and rebuild panel.","2":"Settings \u2014 remote repositories with the GitHub file\/folder tree picker.","3":"Frontend [nvoos_docs]<\/code> embed \u2014 sidebar, content, and table of contents.","4":"Frontend [nvoos_docs]<\/code> embed \u2014 full-text search."}},"plugin_section":[],"plugin_tags":[6941,1673,4608],"plugin_category":[],"plugin_contributors":[277722],"plugin_business_model":[],"class_list":["post-367696","plugin","type-plugin","status-publish","hentry","plugin_tags-documentation","plugin_tags-github","plugin_tags-markdown","plugin_contributors-vsamtani","plugin_committers-vsamtani"],"banners":{"banner":"https:\/\/ps.w.org\/nvoos-docs-hub\/assets\/banner-772x250.png?rev=3731763","banner_2x":"https:\/\/ps.w.org\/nvoos-docs-hub\/assets\/banner-1544x500.png?rev=3731763","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/nvoos-docs-hub\/assets\/icon-128x128.png?rev=3731763","icon_2x":"https:\/\/ps.w.org\/nvoos-docs-hub\/assets\/icon-256x256.png?rev=3731763","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/nvoos-docs-hub\/assets\/screenshot-1.png?rev=3731763","caption":"Settings \u2014 documentation index status and rebuild panel."},{"src":"https:\/\/ps.w.org\/nvoos-docs-hub\/assets\/screenshot-2.png?rev=3731763","caption":"Settings \u2014 remote repositories with the GitHub file\/folder tree picker."},{"src":"https:\/\/ps.w.org\/nvoos-docs-hub\/assets\/screenshot-3.png?rev=3731763","caption":"Frontend [nvoos_docs]<\/code> embed \u2014 sidebar, content, and table of contents."},{"src":"https:\/\/ps.w.org\/nvoos-docs-hub\/assets\/screenshot-4.png?rev=3731763","caption":"Frontend [nvoos_docs]<\/code> embed \u2014 full-text search."}],"raw_content":"\n

NV oOS Docs Hub discovers, indexes, and renders Markdown documentation in a\nGitBook-style single-page app: sidebar navigation, content area, and a\nper-page table of contents. Embed it anywhere on your WordPress site via a\nshortcode or Gutenberg block.<\/p>\n\n

Out of the box it publishes documentation you upload yourself: drop\nMarkdown (.md<\/code>) or text (.txt<\/code>) files into\n wp-content\/uploads\/nvoos-docs-hub\/content\/ (subfolders become sections),\nrebuild the index, and they appear in the browser. No remote services are\ninvolved.<\/p>\n\n

Optional GitHub import (opt-in, off by default).<\/strong> Enable Remote\nRepositories<\/em> in the settings to import Markdown from any public GitHub\nrepository<\/strong> \u2014 no GitHub account required. This is a documentation-import\nservice: the plugin fetches files server-side, over HTTPS, and only from\n api.github.com and raw.githubusercontent.com<\/code>, then stores them in a\nlocal cache on your server. No requests are made unless you enable the\nsetting, configure a repository, and trigger a rebuild. All scripts,\nstyles, fonts, and images are bundled locally \u2014 nothing is loaded from a\nremote server. See External Services<\/strong> below for the full disclosure.<\/p>\n\n

Key features:<\/strong><\/p>\n\n