portosaurus 0.14.0

package/.vscode/snippets.code-snippets

@@ -0,0 +1,79 @@
+{
+    "Note Frontmatter": {
+        "scope": "markdown,mdx",
+        "prefix": "---",
+        "description": "Add frontmatter for a note page",
+        "body": [
+            "---",
+            "title: \"${1:Title}\"",
+            "description: \"${3:Description of the topic}\"",
+            "sidebar_position: ${2:1}",
+            "---"
+        ],
+    },
+                 
+    "Note Index Page": {
+        "scope": "markdown,mdx",
+        "prefix": "index",
+        "description": "\"Add a standard index page structure for note directories\"",
+        "body": [
+            "---",
+            "title: \"${1:Title}\"",
+            "page_type: ${index}",
+            "description: \"${3:Description of the topic}\"",
+            "sidebar_position: ${2:1}",
+            "---",
+            "",        
+            "<div class=\"hide-lines\">",
+            "import { TopicList } from \"@site/src/components/NoteIndex\";",
+            "",
+            "<TopicList/>",
+            "</div>",
+            "",
+            "<div class=\"hide-this\" align=\"center\">",
+            "    <h1>DO NOT EDIT</h1>",
+            "    <h3>This File is Used for Entrypoint of this note.<br/>Do not edit/delete. </h3>",
+            "</div>"
+           
+        ]
+    },
+
+    "DataView JS": {
+        "scope": "markdown,mdx",
+        "prefix": "dataview",
+        "description": "Add a dataview JS code block",
+        "body": [
+            "<h1 align=\"center\" class=\"hide-this\"> Topics</h1>",
+            " ", 
+            "",
+            "```dataviewjs",
+            "const currentFolder = dv.current().file.folder;",
+            "",
+            "const pages = dv.pages(`\"\\${currentFolder}\"`).filter(p =>",
+            "  !p.file.name.toLowerCase().includes(\"index\")",
+            ");",
+            "",
+            "const sortedPages = pages.sort((a, b) => {",
+            "    const aPos = a.sidebar_position !== null ? Number(a.sidebar_position) : null;",
+            "    const bPos = b.sidebar_position !== null ? Number(b.sidebar_position) : null;",
+            "",
+            "    if (aPos !== null && bPos !== null) return aPos - bPos;",
+            "    if (aPos !== null) return -1;",
+            "    if (bPos !== null) return 1;",
+            "",
+            "    return a.file.name.localeCompare(b.file.name);",
+            "});",
+            "",
+            "const tableData = [",
+            "  [\"\\u200B\", \"\\u200B\"],",
+            "  ...sortedPages.map(p => [",
+            "    `-  ${p.title || p.file.name}`,",
+            "    dv.fileLink(p.file.path)",
+            "  ])",
+            "];",
+            "",
+            "dv.table([\"📌 Title\", \"🔗 Link\"], tableData);",
+            "```"
+        ]
+    }
+}

package/AGENTS.md

@@ -0,0 +1,37 @@
+# Portosaurus Agent Context
+
+## Project Overview
+
+Portosaurus is a **Zero-Config Docusaurus Preset** for creating personal portfolio websites.
+It is an NPM package (`portosaurus`) that handles all the complex configuration, theming, and build scripts.
+
+## Architecture
+
+- **Package**: `portosaurus` (NPM)
+- **Core Logic**: `src/index.js` (Docusaurus Preset), `bin/portosaurus.js` (CLI).
+- **User Project**: A minimal folder containing just `config.js` and their content (`blog/`, `notes/`).
+
+## CLI Usage
+
+### Initialize a new project
+
+```bash
+npx portosaurus init my-website
+```
+
+### Run the project
+
+```bash
+# Inside your project folder
+npm run start
+npm run build
+```
+
+## Configuration
+
+The user only interacts with [`config.js`](./config.js). The `portosaurus` CLI automatically generates the necessary Docusaurus configuration behind the scenes.
+
+## Development
+
+- **Codebase**: The `portosaurus` repo contains the Preset code and the Theme components (`src/theme`).
+- To test changes locally, you can link the package or run the `bin/portosaurus.js` script against a test directory.

package/GG/config.js

@@ -0,0 +1,233 @@
+exports.usrConf = {
+
+  auto_update: true,
+
+  dark_mode: true,
+
+  site_url: "https://example.com",
+  site_path: "/",
+
+  srt_url: "${site_url}${site_path}/l",
+
+  rebots_txt: true,
+  social_card: "img/social-card.jpeg",
+  colapsable_sidebar: true,
+  hide_navbar_on_scroll: true,
+  disable_theme_switch: false,
+  rss: true,
+
+  hero_section: {
+    title: "Your Name",
+    profession: "Your Profession",
+    description: "Short description about you, your passion, your goals etc.",
+    profile_pic: "https://raw.githubusercontent.com/soymadip/portosaurus/refs/heads/compiler/static/img/icon.png",
+  },
+
+  about_me: {
+    enable: true,
+
+    image: "${hero_section.profile_pic}",
+
+    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: [
+      "skill 1",
+      "Skill 2",
+      "Skill 3",
+    ],
+    resume_link: "https://exapmple.com/resume",
+  },
+
+  project_shelf: {
+    enable: true,
+    projects: [
+      {
+        title: "Your Awesome Project",
+        featured: true,
+        state: "active",
+        desc: "Desctiption about your awesome project.",
+        image: "https://raw.githubusercontent.com/soymadip/portosaurus/refs/heads/compiler/static/img/icon.png",
+        website: null,
+        github: "https://github.com/soymadip/portosaurus",
+        Demo: "https://soymadip.github.io",
+        tags: ["your project's topic", "this is a tag", "another tag"],
+      },
+    ],
+  },
+
+
+  social_links: {
+
+    enable: true,
+    links: [
+      {
+        name: "Email",
+        icon: "mail",
+        desc: "Send me an email",
+        url: "${srt_url}/mail",
+      },
+      {
+        name: "LinkedIn",
+        icon: "linkedin",
+        desc: "Connect on LinkedIn",
+        url: "${srt_url}/linkedin",
+        pin: true,
+      },
+      {
+        name: "Telegram",
+        icon: "telegram",
+        desc: "Reach me on Telegram",
+        url: "${srt_url}/telegram",
+        pin: true,
+      },
+      {
+        name: "Instagram",
+        icon: "instagram",
+        desc: "Reach me on Instagram",
+        url: "/instagram",
+        pin: true,
+      },
+    ],
+  },
+
+  link_shortener: {
+    // Uses StaticShort
+
+    enable: true,
+    deploy_path: "/l",
+
+    short_links: {
+      mail: "mailto://you@yourDomain.com",
+      github: "https://github.com/yourUserName",
+      gitlab: "https://gitlab.com/yourUserName",
+      linkedin: "https://linkedin.com/in/yourUserName",
+      telegram: "https://telegram.me/yourUserName",
+    },
+  },
+
+  experience: {
+    enable: false,
+    list: [
+      {
+        company: "Company A",
+        position: "Software Engineer",
+        duration: "Jan 2020 - Present",
+        description: [
+          "Developed and maintained web applications using JavaScript, HTML, and CSS.",
+          "Collaborated with cross-functional teams to define, design, and ship new features.",
+          "Identified and fixed bugs to improve application performance.",
+        ],
+      },
+      {
+        company: "Company B",
+        position: "Intern",
+        duration: "Jun 2019 - Dec 2019",
+        description: [
+          "Assisted in the development of internal tools using Python and Bash.",
+          "Participated in code reviews and provided feedback to improve code quality.",
+          "Conducted research and provided recommendations for new technologies.",
+        ],
+      },
+    ],
+  },
+
+
+  tasks_page: {
+    enable: true,
+    tasks: [
+      {
+        title: "Add more Callouts",
+        description: "like question..",
+        status: "pending",
+        priority: "medium",
+      },
+      {
+        title: "Add colors to Markdown Headings",
+        description: "Take from Obsidian",
+        status: "pending",
+        priority: "high",
+      },
+      {
+        title: "Improve the Note card Icon extractor",
+        description:
+          "make it strip number before dir name, currently It shows blank icon(default book).",
+        status: "completed",
+        priority: "high",
+      },
+      {
+        title: "Improve Roadmap page",
+        description:
+          "add sub todos, shift from vibe code to orignal code, make mobile friendly",
+        status: "pending",
+        priority: "low",
+      },
+      {
+        title: "Fix Mermaid Diagram support",
+        description:
+          "showing: Hook is called outside the <ColorModeProvider>. Please see https://docusaurus.io/docs/api/themes/configuration#use-color-mode.",
+        status: "pending",
+        priority: "medium",
+      },
+      {
+        title: "check prism js, dark and light background swap",
+        status: "completed",
+        description: "Looking better now.",
+        priority: "low",
+      },
+      {
+        title: "Make standalone Project.",
+        description: "Convert to Portosaurus project. remove personal stuff.",
+        priority: "high",
+        status: "active",
+      },
+      {
+        title: "Separate portfolio config",
+        description: "Separate portfolio specific settings to config.js.",
+        priority: "high",
+        status: "completed",
+      },
+      {
+        title: "make shortlinks icon field optional",
+        description:
+          "lower the title, then match in mapping. if icon key is defined, use it.",
+        priority: "low",
+        status: "pending",
+      },
+      {
+        title: "Rearrange the config.js",
+        description:
+          "Rearrange config, make more abstract. Add hero section configs.",
+        status: "active",
+        priority: "high",
+      },
+      {
+        title: "Fix favicon logic",
+        description:
+          "Fix favicon gen failed even if given diff value in usrConf.favicon, also when usrConf.hero_section.profile_pic to /img/some-pic.png",
+        status: "active",
+        priority: "high",
+      },
+      {
+        title: "Fix project shelf image placing",
+        description: "The image should align in the middle of card. Then fill the space if needed.",
+        status: "active",
+        priority: "low",
+      },
+      {
+        title: "Add shortlink generation",
+        description: "setup StaticShort while compiling portosaurus.",
+        status: "active",
+        priority: "normal",
+      },
+      {
+        title: "Add placeholder notice When no note is there",
+        description: null,
+        status: "active",
+        priority: "low",
+      },
+    ],
+  }
+}

package/GG/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "GG",
+  "version": "0.0.0",
+  "private": true,
+  "dependencies": {
+    "portosaurus": "^0.14.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "scripts": {
+    "start": "portosaurus start",
+    "build": "portosaurus build"
+  }
+}

package/GG/static/docusaurus-snippet.css

@@ -0,0 +1,3 @@
+.hide-lines {
+  display: none;
+}