portosaurus 1.15.2 → 1.16.1

package/README.md

@@ -37,10 +37,10 @@ npx portosaurus init my-portfolio
 
 **Options:**
 
-- `-gh`: Automatically sets up GitHub Actions workflow for deployment.
-- `--install`: Installs dependencies automatically.
+- `-ngh, --no-github-pages`: Skip setting up GitHub Actions workflow for deployment.
+- `-ni, --no-install`: Skip automatic dependency installation.
 
-### 2. Start Development
+### 2. Start Development Server
 
 Navigate to your project and start the development server:
 
@@ -58,6 +58,26 @@ Your site will be available at `http://localhost:3000`.
 
 ### 3. Build & Deploy
 
+#### GitHub Pages
+
+1. Create a repository on GitHub named `yourUsername.github.io`.
+2. Go to the repo's `Settings` > `Pages` > `Build and deployment` > `Source` > **`GitHub Actions`**.
+3. Push your code:
+   ```bash
+   git remote add origin https://github.com/yourUsername/yourUsername.github.io.git
+   git branch -M main
+   git push -u origin main
+   ```
+
+#### Other Providers
+
+A portosaurus project can be deployed to any static hosting provider like:
+
+- Netlify
+- Vercel
+- Cloudflare Pages
+- Other static providers
+
 To generate the static site for production:
 
 ```bash
@@ -70,18 +90,15 @@ npm run build
 
 The output will be in the `build/` directory.
 
-#### GitHub Pages (Automated)
+To preview the production build locally:
 
-If you used the `-gh` flag during init, just push to your repository:
+```bash
+# With Bun
+bun run serve
 
-1. Create a repository on GitHub.
-2. Push your code:
-   ```bash
-   git remote add origin https://github.com/username/repo.git
-   git branch -M main
-   git push -u origin main
-   ```
-3. Go to GitHub Settings > Pages > Build and deployment > Source > **GitHub Actions**.
+# With npm
+npm run serve
+```
 
 <br>
 

package/bin/portosaurus.js

@@ -18,8 +18,8 @@ import { fileURLToPath } from "url";
 import { spawn, execSync } from "child_process";
 import { createRequire } from "module";
 
-import { logger } from "../utils/logger.js";
-import { createConfig } from "../utils/createConfig.js";
+import { logger } from "../src/utils/logger.js";
+import { createConfig } from "../src/utils/createConfig.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -32,14 +32,18 @@ const program = new Command();
 program
   .name("portosaurus")
   .description("CLI for Portosaurus - The complete portfolio solution")
-  .version(
-    packageJson.version,
-    "-v, --version",
-    "output the current version",
-  );
+  .version(packageJson.version, "-v, --version", "output the current version");
 
 // ----------- HELPERS -------------
 
+// Helper to clean up internal index.md from user notes
+function cleanUserNotesIndex(projectRoot) {
+  const userNotesIndex = path.join(projectRoot, "notes", "index.md");
+  if (existsSync(userNotesIndex)) {
+    removeSync(userNotesIndex);
+  }
+}
+
 async function prepareDocusaurusRun(projectRoot) {
   const configPath = path.join(projectRoot, "config.js");
 
@@ -52,36 +56,42 @@ async function prepareDocusaurusRun(projectRoot) {
   }
 
   // Ensure internal files are synced to .portosaurus
-  const internalSrc = path.join(__dirname, "../internal/src");
-  const internalSidebars = path.join(__dirname, "../internal/sidebars.js");
-  const internalNotesIndex = path.join(__dirname, "../internal/notes/index.md");
-
-  const dotPorto = path.join(projectRoot, ".portosaurus");
-  const userSrc = path.join(dotPorto, "src");
-  const userSidebars = path.join(dotPorto, "sidebars.js");
-
-  // Ensure .portosaurus exists
-  fs.ensureDirSync(dotPorto);
-
-  // Always copy/overwrite src/
-  fs.copySync(internalSrc, userSrc);
-
-  // Always copy/overwrite sidebars.js
-  fs.copySync(internalSidebars, userSidebars);
-
-  // Ensure user has essential folders
-  const userRootNotes = path.join(projectRoot, "notes");
-  const userRootBlog = path.join(projectRoot, "blog");
-  const userRootStatic = path.join(projectRoot, "static");
-
-  fs.ensureDirSync(userRootNotes);
-  fs.ensureDirSync(userRootBlog);
-  fs.ensureDirSync(userRootStatic);
-
-  // Always ensure index.md exists (framework-managed file)
-  const userNotesIndex = path.join(userRootNotes, "index.md");
-  if (!fs.existsSync(userNotesIndex)) {
-    fs.copySync(internalNotesIndex, userNotesIndex);
+  const internalDir = path.join(__dirname, "../src/internal");
+  const runtimeDir = path.join(projectRoot, ".portosaurus");
+
+  // Ensure .portosaurus exists and is clean
+  fs.emptyDirSync(runtimeDir);
+
+  // Ensure user has essential folders in project root
+  fs.ensureDirSync(path.join(projectRoot, "notes"));
+  fs.ensureDirSync(path.join(projectRoot, "blog"));
+  fs.ensureDirSync(path.join(projectRoot, "static"));
+
+  // 1. Copy everything from internal to .portosaurus
+  fs.copySync(internalDir, runtimeDir);
+
+  // 2. Overwrite with user files if they exist in project root
+  const syncItems = [
+    ...new Set([...readdirSync(internalDir), "blog", "static"]),
+  ];
+  for (const file of syncItems) {
+    const userFile = path.resolve(projectRoot, file);
+    const destFile = path.resolve(runtimeDir, file);
+
+    if (existsSync(userFile)) {
+      if (fs.statSync(userFile).isDirectory()) {
+        fs.ensureDirSync(destFile);
+      }
+      fs.copySync(userFile, destFile, {
+        overwrite: true,
+        filter: (src) => {
+          if (src.endsWith(path.join("notes", "index.md"))) {
+            return false;
+          }
+          return true;
+        },
+      });
+    }
   }
 
   // Load user config
@@ -110,7 +120,7 @@ async function prepareDocusaurusRun(projectRoot) {
   const docusaurusConfig = createConfig(userConfig, projectRoot);
 
   // Write temp config file INSIDE .portosaurus
-  const tempConfigPath = path.join(dotPorto, "docusaurus.config.js");
+  const tempConfigPath = path.join(runtimeDir, "docusaurus.config.js");
 
   const configContent = `// Auto-generated by Portosaurus
 module.exports = ${JSON.stringify(docusaurusConfig, null, 2)};`;
@@ -118,12 +128,12 @@ module.exports = ${JSON.stringify(docusaurusConfig, null, 2)};`;
   writeFileSync(tempConfigPath, configContent);
   logger.success("Generated Docusaurus config in .portosaurus.");
 
-  return { dotPorto };
+  return { runtimeDir };
 }
 
-async function runDocusaurus(command, args, dotPorto, projectRoot) {
+async function runDocusaurus(command, args, runtimeDir, projectRoot) {
   // Detect package manager and find docusaurus binary
-  const { findDocusaurusBin } = await import("../utils/packageManager.js");
+  const { findDocusaurusBin } = await import("../src/utils/packageManager.js");
   const docusaurus = findDocusaurusBin(projectRoot || process.cwd());
 
   logger.info(
@@ -132,7 +142,7 @@ async function runDocusaurus(command, args, dotPorto, projectRoot) {
 
   const child = spawn(
     docusaurus.command,
-    [...docusaurus.args, command, dotPorto, ...args],
+    [...docusaurus.args, command, runtimeDir, ...args],
     {
       stdio: "inherit",
       cwd: projectRoot,
@@ -180,7 +190,7 @@ program
       mkdirSync(projectPath);
 
       // Copy template files
-      const templatePath = path.resolve(__dirname, "../template");
+      const templatePath = path.resolve(__dirname, "../src/template");
 
       // Check if template exists (it might not be populated yet)
       if (!existsSync(templatePath)) {
@@ -213,6 +223,7 @@ program
         scripts: {
           dev: "portosaurus dev",
           start: "portosaurus start",
+          serve: "portosaurus serve",
           build: "portosaurus build",
         },
         dependencies: {
@@ -255,7 +266,7 @@ program
 
       // Detect package manager for install instructions
       const { detectPackageManager } =
-        await import("../utils/packageManager.js");
+        await import("../src/utils/packageManager.js");
       const pm = detectPackageManager(projectPath) || "npm";
       const installCmd = pm === "npm" ? "npm install" : `${pm} install`;
       const runCmd = pm === "npm" ? "npm run" : `${pm} run`;
@@ -301,11 +312,13 @@ program
     const projectRoot = process.cwd();
     logger.info("Starting development server...");
     try {
-      const { dotPorto } = await prepareDocusaurusRun(projectRoot);
-      await runDocusaurus("start", [], dotPorto, projectRoot);
+      const { runtimeDir } = await prepareDocusaurusRun(projectRoot);
+      await runDocusaurus("start", [], runtimeDir, projectRoot);
     } catch (error) {
       logger.error(`Failed to start: ${error.message}`);
       process.exit(1);
+    } finally {
+      cleanUserNotesIndex(projectRoot);
     }
   });
 
@@ -319,12 +332,12 @@ program
     logger.info("Building Portosaurus site...");
 
     try {
-      const { dotPorto } = await prepareDocusaurusRun(projectRoot);
+      const { runtimeDir } = await prepareDocusaurusRun(projectRoot);
 
       const buildDir = path.join(projectRoot, "build");
       const args = ["--out-dir", buildDir];
 
-      await runDocusaurus("build", args, dotPorto, projectRoot);
+      await runDocusaurus("build", args, runtimeDir, projectRoot);
 
       // Create .nojekyll for GitHub Pages compatibility
       const nojekyllPath = path.join(buildDir, ".nojekyll");
@@ -338,6 +351,42 @@ program
     } catch (error) {
       logger.error(`Failed to build: ${error.message}`);
       process.exit(1);
+    } finally {
+      cleanUserNotesIndex(projectRoot);
+    }
+  });
+
+// --- SERVE COMMAND ---
+
+program
+  .command("serve")
+  .description("Serve the built static site locally")
+  .action(async () => {
+    const projectRoot = process.cwd();
+    logger.info("Serving Portosaurus site...");
+
+    try {
+      const { runtimeDir } = await prepareDocusaurusRun(projectRoot);
+      const buildDir = path.join(projectRoot, "build");
+
+      if (!existsSync(buildDir)) {
+        logger.error(
+          "Build directory not found. Run 'portosaurus build' first.",
+        );
+        process.exit(1);
+      }
+
+      await runDocusaurus(
+        "serve",
+        ["--dir", buildDir],
+        runtimeDir,
+        projectRoot,
+      );
+    } catch (error) {
+      logger.error(`Failed to serve: ${error.message}`);
+      process.exit(1);
+    } finally {
+      cleanUserNotesIndex(projectRoot);
     }
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portosaurus",
-  "version": "1.15.2",
+  "version": "1.16.1",
   "author": "soymadip",
   "license": "GPL-3.0-only",
   "description": "Complete portfolio cum personal website solution for your digital personality.",
@@ -26,9 +26,9 @@
   },
   "files": [
     "bin/",
-    "internal/",
-    "template/",
-    "utils/"
+    "src/internal/",
+    "src/template/",
+    "src/utils/"
   ],
   "dependencies": {
     "@docusaurus/core": "^3.9.2",

package/src/internal/README.md

@@ -0,0 +1,3 @@
+# Inernals
+
+Everything in this dir will copied at runtime at portusaurus working dir and will be overriten if user has any duplicate file.

package/src/template/README.md

@@ -0,0 +1,82 @@
+<br>
+<div align="center">
+    <img src="https://raw.githubusercontent.com/soymadip/portosaurus/refs/heads/compiler/static/img/icon.png" width=90>
+    <h1>My Portfolio Site</h1>
+    <p>
+        Complete portfolio cum personal website for my digital personality
+        <br>
+        <small>Made with <a href="https://github.com/soymadip/portosaurus">Portosaurus</a></small>
+    </p>
+</div>
+
+## Project Structure
+
+```
+.
+├── config.js          # Site configuration
+├── blog/              # Blog posts    (Markdown/MDX)
+├── notes/             # Documentation (Markdown/MDX)
+├── static/            # Static assets (images, files, binaries)
+└── package.json       # Dependencies
+```
+
+## Configuration
+
+Edit [`config.js`](./config.js) to customize your site. See the [Portosaurus documentation](https://github.com/soymadip/portosaurus#configuration) for all available options.
+
+## Development
+
+Start the development server:
+
+```bash
+# With Bun
+bun run dev
+
+# With npm
+npm run dev
+```
+
+The site will be available at `http://localhost:3000`.
+
+## Build & Deploy
+
+### GitHub Pages
+
+1. Create a repository on GitHub named `yourUsername.github.io`.
+2. Go to the repo's `Settings` > `Pages` > `Build and deployment` > `Source` > **`GitHub Actions`**.
+3. Push your code:
+   ```bash
+   git remote add origin https://github.com/yourUsername/yourUsername.github.io.git
+   git branch -M main
+   git push -u origin main
+   ```
+
+### Other Providers
+
+A portosaurus project can be deployed to any static hosting provider like:
+
+- Netlify
+- Vercel
+- Cloudflare pages
+- Other static providers
+
+To generate the static site for production:
+
+```bash
+# With Bun
+bun run build
+
+# With npm
+npm run build
+```
+
+The output will be in the `build/` directory.
+
+---
+
+<div align="center">
+
+Made with [Portosaurus](https://github.com/soymadip/portosaurus)
+
+<br>
+</div>

package/src/template/blog/authors.yml

@@ -0,0 +1,5 @@
+you:
+  name: Your Name
+  title: Maintainer
+  url: https://github.com/yourUsername
+  image_url: https://github.com/yourUsername.png

package/{template → src/template}/blog/welcome.md

@@ -1,7 +1,7 @@
 ---
 slug: welcome
 title: Welcome
-authors: [soymadip]
+authors: [you]
 tags: [hello, portosaurus]
 ---
 

package/{template/notes/getting-started.md → src/template/notes/welcome.md}

@@ -1,4 +1,5 @@
 ---
+title: getting-started
 sidebar_position: 1
 ---
 

package/{utils → src/utils}/createConfig.js

@@ -5,9 +5,11 @@ import { fileURLToPath } from "url";
 
 const require = createRequire(import.meta.url);
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
 const internalUtils = path.resolve(__dirname, "../internal/src/utils");
 
+
+//---------------------- helpers -------------------------
+
 /**
  * Resolves the site URL based on config value and environment.
  * @param {string} configValue - The site_url value from user config.
@@ -43,12 +45,15 @@ function resolveBasePath(configValue) {
   return configValue;
 }
 
+//--------------------- Config Creation ---------------------
+
 /**
  * Creates a Docusaurus config from the Portosaurus user config.
  * @param {Object} userConfig - The user configuration object (export of config.js).
  * @returns {Object} Docusaurus configuration object.
  **/
 export function createConfig(userConfig, projectRoot = process.cwd()) {
+
   const usrConf = userConfig.usrConf || {};
 
   //------------- Basic mapping -------------
@@ -63,13 +68,11 @@ export function createConfig(userConfig, projectRoot = process.cwd()) {
   const faviconPath =
     usrConf.hero_section?.profile_pic || "https://github.com/soymadip.png";
 
-  const title = usrConf.hero_section?.title || projName;
-  const tagline = usrConf.hero_section?.description || projDesc;
-
-  // Resolve paths relative to project root (where config.js is)
-  const notesPath = path.resolve(projectRoot, "notes");
-  const blogPath = path.resolve(projectRoot, "blog");
-  const staticPath = path.resolve(projectRoot, "static");
+  // Resolve paths relative to .portosaurus (the build context)
+  const runtimeDir = path.resolve(projectRoot, ".portosaurus");
+  const notesPath = path.resolve(runtimeDir, "notes");
+  const blogPath = path.resolve(runtimeDir, "blog");
+  const staticPath = path.resolve(runtimeDir, "static");
 
   // ---------- Docusaurus Config -----------
   const config = {
@@ -109,7 +112,7 @@ export function createConfig(userConfig, projectRoot = process.cwd()) {
           docs: {
             path: notesPath,
             routeBasePath: "notes",
-            sidebarPath: "./sidebars.js", // Inside .portosaurus
+            sidebarPath: "./src/config/sidebars.js", // Inside .portosaurus
             // editUrl: '...',
           },
           blog: {
@@ -209,8 +212,8 @@ export function createConfig(userConfig, projectRoot = process.cwd()) {
         {
           hashed: true,
           indexDocs: true,
-          docsDir: notesPath,
-          blogDir: blogPath,
+          docsDir: "notes",
+          blogDir: "blog",
           docsRouteBasePath: "notes",
           highlightSearchTermsOnTargetPage: true,
           explicitSearchResultPath: true,

package/{utils → src/utils}/packageManager.js

@@ -34,7 +34,7 @@ export function detectPackageManager(projectRoot) {
     }
   }
 
-  return "npm"; // Ultimate fallback
+  return "npm"; // fallback
 }
 
 /**
@@ -44,6 +44,7 @@ export function detectPackageManager(projectRoot) {
 export function getRunCommand(packageManager, binaryName, args = []) {
   switch (packageManager) {
     case "bun":
+
       // Bun can run binaries directly with `bun run`
       return {
         command: "bun",

package/src/utils/ss.js

@@ -0,0 +1,294 @@
+import { catppuccinMocha, catppuccinLatte } from "./src/config/prism.js";
+import { appVersion } from "./src/utils/appVersion.js";
+import { metaTags } from "./src/config/metaTags.js";
+import { usrConf } from "./src/utils/compileConfig.js";
+import { useEnabled } from "./src/utils/filterEnabledItems.js";
+
+const projectName = "Portosaurus";
+const projectVersion = appVersion();
+const faviconPath = 'favicon/favicon.ico';
+const iconPicPath = 'static/img/icon.png';
+
+const config = {
+
+  projectName: `${projectName}`,
+
+  title: usrConf.hero_section.title || `${projectName}`,
+
+  tagline: usrConf.hero_section.tagline || "Your complete portfolio solution",
+
+  favicon: usrConf.favicon || `${faviconPath}`,
+
+  url: usrConf.site_url,
+  baseUrl: usrConf.site_path || "/",
+
+  // GH Pages config
+  organizationName: usrConf.hero_section.title || `${projectName} `,
+  deploymentBranch: "gh-pages",
+
+  onBrokenAnchors: "ignore",
+  onBrokenLinks: "warn",
+  // onBrokenMarkdownLinks: "warn",
+
+  i18n: {
+    defaultLocale: "en",
+    locales: ["en"],
+  },
+
+  headTags: metaTags,
+
+  customFields: {
+    version: `${projectVersion}`,
+
+    heroSection: {
+      profilePic: usrConf.hero_section.profile_pic || `${iconPicPath}`,
+      intro: usrConf.hero_section.intro || "Hello there, I'm",
+      title: usrConf.hero_section.title || "Your Name",
+      subtitle: usrConf.hero_section.subtitle || 'I am a',
+      profession: usrConf.hero_section.profession || 'Your Profession',
+      description: usrConf.hero_section.description || "Short description about your profession, passion, goals.",
+      learnMoreButtonTxt: usrConf.hero_section.learn__more_button_txt || "Learn More",
+    },
+
+    aboutMe: {
+      enable: usrConf.about_me.enable || true,
+
+      image:       usrConf.about_me.image || `${iconPicPath}`,
+      description: usrConf.about_me.description || [
+        "I'm a passionate FOSS developer with expertise in designing and building solutions for real-world problems.",
+        "My journey in software development started with a simple desire to automate repetitive tasks, specially in my PC.",
+      ],
+      skills: usrConf.about_me.skills || ["skill 1", "Skill 2"],
+      resumeLink: usrConf.about_me.resume_link || "https://example.com/resume",
+    },
+
+    projects: usrConf.project_shelf,
+
+    experience: usrConf.experience,
+
+    socialLinks: {
+      enable: usrConf.social_links.enable || true,
+
+      links: usrConf.social_links.links || [
+        {
+          name: "Your Instagram",
+          icon: "instagram",
+          desc: "Your Instagram profile link",
+          url: "https://instagram.com/yourprofile",
+        },
+      ],
+    },
+
+    robotsTxt: {
+      enable: usrConf.robots_txt || true,
+      rules: [
+        {
+          disallow: ["/notes/", "/tasks/"],
+        },
+      ],
+      customLines: [],
+    },
+
+    tasksPage: {
+      enable: usrConf.tasks_page.enable || true,
+      title: usrConf.tasks_page.title || "Tasks",
+      description: usrConf.tasks_page.description || "Track your tasks and projects here.",
+      taskList: usrConf.tasks_page.tasks || [
+        {
+          title: "Example Tasks",
+          description: "Description of the task",
+          status: "active",
+          priority: "high",
+        },
+      ],
+    },
+  },
+
+  presets: [
+    [
+      "classic",
+      {
+        docs: {
+          routeBasePath: "notes",
+          path: "notes",
+          sidebarPath: "./src/config/sidebar.js",
+
+          admonitions: {
+            keywords: ["note", "tip", "info", "warning", "danger", "question"],
+            extendDefaults: true,
+          },
+        },
+
+        blog: {
+
+          feedOptions: usrConf.rss
+            ? {
+                type: ["rss", "atom"],
+                xslt: true,
+              }
+            : undefined,
+
+          showReadingTime: false,
+
+          onInlineTags: "warn",
+          onInlineAuthors: "warn",
+          onUntruncatedBlogPosts: "warn",
+        },
+
+        theme: {
+          customCss: "./src/css/custom.css",
+        },
+
+      },
+    ],
+  ],
+
+  // themes: ['@docusaurus/theme-mermaid'],
+  markdown: {
+    mermaid: true,
+    hooks: {
+      onBrokenMarkdownLinks: "warn"
+    }
+  },
+
+  themeConfig: {
+    // Social card
+    image: usrConf.social_card || "img/social-card.jpeg",
+
+    docs: {
+      sidebar: {
+        hideable: usrConf.collapsable_sidebar || true,
+      },
+    },
+
+    imageZoom: {
+      options: {
+        margin: 2,
+        background: "rgba(var(--ifm-background-color-rgb), 0.9)",
+      },
+    },
+
+    // Default: Dark mode
+    colorMode: {
+      defaultMode: usrConf.dark_mode ? "dark" : "light",
+      disableSwitch: usrConf.disable_theme_switch || false,
+    },
+
+    navbar: {
+      title: usrConf.hero_section.title || `${projectName} `,
+      hideOnScroll: usrConf.hide_navbar_on_scroll || true,
+
+      logo: {
+        alt: "Site Logo",
+        src: usrConf.favicon || `${faviconPath}`,
+      },
+
+      items: useEnabled([
+        {
+          type: "search",
+          position: "right",
+          className: "navbar-search-bar",
+        },
+        {
+          enable: usrConf.about_me?.enable || true,
+          value: {
+            label: "About Me",
+            to: "/#about",
+            position: "right",
+            activeBaseRegex: "^/#about",
+          },
+        },
+        {
+          enable: usrConf.project_shelf?.enable || true,
+          value: {
+            label: "Projects",
+            to: "/#projects",
+            position: "right",
+            activeBaseRegex: "^/#projects",
+          },
+        },
+        {
+          enable: usrConf.experience?.enable || false,
+          value: {
+            label: "Experience",
+            to: "/#experience",
+            position: "right",
+            activeBaseRegex: "^/#experience",
+          },
+        },
+        {
+          enable: usrConf.social_links?.enable || true,
+          value: {
+            label: "Contact",
+            to: "/#contact",
+            position: "right",
+            activeBaseRegex: "^/$contact",
+          },
+        },
+        {
+          type: "dropdown",
+          label: "More",
+          position: "right",
+          className: "_navbar-more-items",
+          items: useEnabled([
+            { label: "Notes", to: "/notes" },
+            { label: "Blog", to: "/blog" },
+            { label: "Tasks", to: "/tasks" },
+            {
+              enable: usrConf.disable_branding ? false : true,
+              value: {
+                label: `Portosaurus v${projectVersion}`,
+                className: "_nav-protosaurus-version",
+                to: "https://github.com/soymadip/portosaurus",
+              },
+            },
+          ]),
+        }
+      ]),
+    },
+
+    tableOfContents: {
+      minHeadingLevel: 2,
+      maxHeadingLevel: 4,
+    },
+
+    prism: {
+      theme: catppuccinLatte,
+      darkTheme: catppuccinMocha,
+      additionalLanguages: ["java", "php", "bash"],
+    },
+
+    footer: {
+      /* links: [
+        {
+            label: 'GitHub',
+            href: 'https://github.com/',
+          }
+        ],
+        copyright: `Copyright © ${new Date().getFullYear()} ` + ownerName,
+      */
+    },
+  },
+
+  plugins: [
+    require.resolve("./src/utils/generateFavicon"),
+    require.resolve("./src/utils/generateRobotsTxt"),
+    [
+      require.resolve("@easyops-cn/docusaurus-search-local"),
+      {
+        hashed: true,
+        indexDocs: true,
+        docsDir: "notes",
+        docsRouteBasePath: "notes",
+        highlightSearchTermsOnTargetPage: true,
+        explicitSearchResultPath: true,
+        hideSearchBarWithNoSearchContext: true,
+        searchContextByPaths: ["notes", "blog"],
+        language: ["en"],
+      },
+    ],
+    "plugin-image-zoom",
+  ],
+};
+
+export default config;

package/internal/src/config/sidebar.js

@@ -1,20 +0,0 @@
-
-const sidebar = {
-  
-  notes: [
-    {
-      type: 'category',
-      label: 'Notes',
-      link: { type: 'doc', id: 'index' },
-      items: [
-        {
-          type: 'autogenerated',
-          dirName: '.'
-        }
-      ]
-    }
-  ]
-};
-
-
-module.exports = sidebar;

package/template/README.md

@@ -1,70 +0,0 @@
-# Portosaurus Project
-
-A portfolio website built with [Portosaurus](https://github.com/soymadip/portosaurus).
-
-## Getting Started
-
-### Development
-
-Start the development server:
-
-```bash
-# With Bun
-bun run dev
-
-# With npm
-npm run dev
-```
-
-The site will be available at `http://localhost:3000`.
-
-### Build
-
-Build the static site:
-
-```bash
-# With Bun
-bun run build
-
-# With npm
-npm run build
-```
-
-The output will be in the `build/` directory.
-
-## Project Structure
-
-```
-.
-├── config.js          # Site configuration
-├── blog/              # Blog posts (Markdown)
-├── notes/             # Documentation (Markdown)
-├── static/            # Static assets (images, files)
-└── package.json       # Dependencies
-```
-
-## Configuration
-
-Edit `config.js` to customize your site. See the [Portosaurus documentation](https://github.com/soymadip/portosaurus) for all available options.
-
-## Deployment
-
-### GitHub Pages
-
-1. Push your project to GitHub
-2. Go to Settings > Pages
-3. Set Source to "GitHub Actions"
-4. The site will deploy automatically on push
-
-### Other Platforms
-
-The `build/` directory contains a static site that can be deployed to:
-
-- Vercel
-- Netlify
-- Cloudflare Pages
-- Any static hosting service
-
----
-
-Made with [Portosaurus](https://github.com/soymadip/portosaurus)

package/template/blog/authors.yml

@@ -1,5 +0,0 @@
-soymadip:
-  name: soymadip
-  title: Maintainer
-  url: https://github.com/soymadip
-  image_url: https://github.com/soymadip.png