portosaurus 1.16.1 → 1.16.2

package/bin/portosaurus.js

@@ -62,29 +62,20 @@ async function prepareDocusaurusRun(projectRoot) {
   // 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);
+  const internalFiles = readdirSync(internalDir);
+
+  for (const file of internalFiles) {
+    const userFile = path.join(projectRoot, file);
 
     if (existsSync(userFile)) {
-      if (fs.statSync(userFile).isDirectory()) {
-        fs.ensureDirSync(destFile);
-      }
-      fs.copySync(userFile, destFile, {
+      fs.copySync(userFile, path.join(runtimeDir, file), {
         overwrite: true,
         filter: (src) => {
+          // Ignore notes/index.md
           if (src.endsWith(path.join("notes", "index.md"))) {
             return false;
           }
@@ -94,6 +85,15 @@ async function prepareDocusaurusRun(projectRoot) {
     }
   }
 
+  // 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);
+
   // Load user config
   const require = createRequire(import.meta.url);
 
@@ -302,6 +302,8 @@ program
     }
   });
 
+
+
 // --- START COMMAND ---
 
 program

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portosaurus",
-  "version": "1.16.1",
+  "version": "1.16.2",
   "author": "soymadip",
   "license": "GPL-3.0-only",
   "description": "Complete portfolio cum personal website solution for your digital personality.",

package/src/utils/createConfig.js

@@ -5,10 +5,8 @@ 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 -------------------------
+const internalUtils = path.resolve(__dirname, "../internal/src/utils");
 
 /**
  * Resolves the site URL based on config value and environment.
@@ -45,15 +43,12 @@ 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 -------------
@@ -212,8 +207,8 @@ export function createConfig(userConfig, projectRoot = process.cwd()) {
         {
           hashed: true,
           indexDocs: true,
-          docsDir: "notes",
-          blogDir: "blog",
+          docsDir: notesPath,
+          blogDir: blogPath,
           docsRouteBasePath: "notes",
           highlightSearchTermsOnTargetPage: true,
           explicitSearchResultPath: true,

package/src/internal/src/utils/compileConfig.js

@@ -1,82 +0,0 @@
-
-// Import the config
-const rawConfig = require('../../config.js');
-
-function resolvePath(obj, path) {
-  const parts = path.split('.');
-  let current = obj;
-
-  for (const part of parts) {
-    if (current === null || current === undefined || typeof current !== 'object') {
-      return undefined;
-    }
-    current = current[part];
-  }
-
-  return current;
-}
-
-function parseStringValue(value, config) {
-
-  if (typeof value !== 'string') {
-    return value;
-  }
-
-  // Find all ${...} references
-  return value.replace(/\${([^}]+)}/g, (match, path) => {
-    const resolvedValue = resolvePath(config, path);
-    
-    if (resolvedValue === undefined) {
-      console.warn(`Warning: Could not resolve reference "${path}" in config value "${value}"`);
-      return match;
-    }
-    
-    if (typeof resolvedValue === 'string' && resolvedValue.includes('${')) {
-      return parseStringValue(resolvedValue, config);
-    }
-    
-    return resolvedValue;
-  });
-}
-
-
-function parseConfigObject(obj, config) {
-
-  if (Array.isArray(obj)) {
-    return obj.map(item => parseConfigObject(item, config));
-  }
-  
-  if (obj !== null && typeof obj === 'object') {
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-      result[key] = parseConfigObject(value, config);
-    }
-    return result;
-  }
-  
-  if (typeof obj === 'string') {
-    return parseStringValue(obj, config);
-  }
-  
-  return obj;
-}
-
-
-function parseConfig(config) {
-
-  const parsedConfig = JSON.parse(JSON.stringify(config));
-  return parseConfigObject(parsedConfig, config);
-}
-
-// Parse the raw config
-const parsedExports = {};
-for (const key in rawConfig) {
-  parsedExports[key] = parseConfig(rawConfig[key]);
-}
-
-module.exports = {
-    ...parsedExports,
-    parseConfig,
-    parseStringValue,
-    resolvePath,
-}

package/src/utils/ss.js

@@ -1,294 +0,0 @@
-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;