portosaurus 1.14.0

package/internal/src/utils/imageProcessor.js

@@ -0,0 +1,134 @@
+const sharp = require('sharp');
+
+// AI GENERATED
+
+/**
+ * Reshapes an image to various predefined shapes
+ * 
+ * @param {string} imagePath - Path to the input image
+ * @param {string} outputPath - Path to save the processed image
+ * @param {string} [shape='circle'] - Shape to apply ('circle', 'square', 'rounded', 'hexagon', 'shield')
+ * @param {number} [roundedCornerRadius=50] - Corner radius for rounded shape (percentage)
+ * @returns {Promise<string>} - A promise that resolves with the path to the processed image
+ */
+async function reshapeImage(imagePath, outputPath, shape = 'circle', roundedCornerRadius = 50) {
+  console.log(`[INFO] Processing image to ${shape} shape...`);
+  
+  try {
+    // Get image dimensions
+    const metadata = await sharp(imagePath).metadata();
+    const size = Math.min(metadata.width, metadata.height);
+    
+    let shapeMask;
+    
+    switch (shape.toLowerCase()) {
+      case 'circle':
+        shapeMask = Buffer.from(
+          `<svg><circle cx="${size/2}" cy="${size/2}" r="${size/2}" fill="white"/></svg>`
+        );
+        break;
+        
+      case 'square':
+        // No mask needed for square, just resize to equal width/height
+        await sharp(imagePath)
+          .resize(size, size, { fit: 'cover' })
+          .toFile(outputPath);
+        return outputPath;
+        
+      case 'rounded':
+        // Convert percentage to actual pixels (e.g., 50% becomes size/4)
+        const radius = Math.min(100, Math.max(0, roundedCornerRadius)) * size / 200;
+        shapeMask = Buffer.from(
+          `<svg><rect x="0" y="0" width="${size}" height="${size}" rx="${radius}" ry="${radius}" fill="white"/></svg>`
+        );
+        break;
+        
+      case 'hexagon':
+        // Calculate hexagon points
+        const centerX = size / 2;
+        const centerY = size / 2;
+        const hexRadius = size / 2;
+        let points = '';
+        for (let i = 0; i < 6; i++) {
+          const angleDeg = 60 * i - 30;
+          const angleRad = Math.PI / 180 * angleDeg;
+          const x = centerX + hexRadius * Math.cos(angleRad);
+          const y = centerY + hexRadius * Math.sin(angleRad);
+          points += `${x},${y} `;
+        }
+        shapeMask = Buffer.from(
+          `<svg><polygon points="${points}" fill="white"/></svg>`
+        );
+        break;
+        
+      case 'shield':
+        const shieldWidth = size;
+        const shieldHeight = size;
+        const bottomCurve = size / 3;
+        shapeMask = Buffer.from(
+          `<svg>
+            <path d="M ${shieldWidth/2},0
+                     L ${shieldWidth},${shieldHeight/3}
+                     C ${shieldWidth},${shieldHeight-bottomCurve} ${shieldWidth/2},${shieldHeight} ${shieldWidth/2},${shieldHeight}
+                     C ${shieldWidth/2},${shieldHeight} 0,${shieldHeight-bottomCurve} 0,${shieldHeight/3}
+                     L ${shieldWidth/2},0 Z" 
+                  fill="white"/>
+          </svg>`
+        );
+        break;
+        
+      default:
+        // Default to circle if shape is not recognized
+        console.warn(`Shape "${shape}" not recognized, defaulting to circle`);
+        shapeMask = Buffer.from(
+          `<svg><circle cx="${size/2}" cy="${size/2}" r="${size/2}" fill="white"/></svg>`
+        );
+    }
+    
+    // Apply the mask and save the final image
+    await sharp(imagePath)
+      .resize(size, size, { fit: 'cover' })
+      .composite([
+        {
+          input: shapeMask,
+          blend: 'dest-in'
+        }
+      ])
+      .png()
+      .toFile(outputPath);
+      
+    return outputPath;
+  } catch (error) {
+    console.error(`Error reshaping image to ${shape}:`, error);
+    throw error;
+  }
+}
+
+/**
+ * Resizes an image while maintaining aspect ratio
+ * 
+ * @param {string} imagePath - Path to the input image
+ * @param {string} outputPath - Path to save the processed image
+ * @param {number} maxWidth - Maximum width of the output image
+ * @param {number} maxHeight - Maximum height of the output image
+ * @returns {Promise<string>} - A promise that resolves with the path to the processed image
+ */
+async function resizeImage(imagePath, outputPath, maxWidth, maxHeight) {
+  console.log(`Resizing image to max ${maxWidth}x${maxHeight}...`);
+  
+  await sharp(imagePath)
+    .resize(maxWidth, maxHeight, {
+      fit: 'inside',
+      withoutEnlargement: true
+    })
+    .toFile(outputPath);
+    
+  return outputPath;
+}
+
+
+
+module.exports = {
+    reshapeImage,
+    resizeImage,
+};

package/internal/src/utils/updateTitle.js

@@ -0,0 +1,107 @@
+import { useEffect, useState } from 'react';
+import { useLocation } from '@docusaurus/router';
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+
+// AI Generated
+
+/**
+ * UpdateTitle component that changes the page title based on the section in view
+ * @param {Object} props              - Component props
+ * @param {Object} props.sections     - Map of section IDs to their corresponding titles
+ * @param {string} props.defaultTitle - Default title to use when no section is prominently visible
+ * @param {boolean} props.enabled     - Whether the dynamic title functionality is enabled
+ * @returns {null} This component doesn't render anything visible
+ */
+
+
+export default function UpdateTitle({ 
+  sections = {}, 
+  defaultTitle = null,
+  enabled = true 
+}) {
+  const location = useLocation();
+  const { siteConfig } = useDocusaurusContext();
+  const [currentTitle, setCurrentTitle] = useState(null);
+
+  // Use the provided default title or fall back to site title
+  const effectiveDefaultTitle = defaultTitle || siteConfig.title;
+
+  useEffect(() => {
+
+    // Only run if enabled
+    if (!enabled) return;
+
+    // Use provided sections or default to empty object
+    const sectionTitles = Object.keys(sections).length > 0 
+      ? sections 
+      : {};
+
+    const updateTitle = () => {
+      // Get all sections we want to track
+      const sectionsToTrack = Object.keys(sectionTitles)
+        .map(id => document.getElementById(id))
+        .filter(Boolean);
+      
+      if (sectionsToTrack.length === 0) {
+        // No sections found, use default title
+        setCurrentTitle(effectiveDefaultTitle);
+        return;
+      }
+      
+      // Calculate which section is most visible
+      const viewportHeight = window.innerHeight;
+      let maxVisibleSection = null;
+      let maxVisibleArea = 0;
+      
+      sectionsToTrack.forEach(section => {
+        const rect = section.getBoundingClientRect();
+        const visibleTop = Math.max(0, rect.top);
+        const visibleBottom = Math.min(viewportHeight, rect.bottom);
+        const visibleArea = Math.max(0, visibleBottom - visibleTop);
+        
+        if (visibleArea > maxVisibleArea) {
+          maxVisibleArea = visibleArea;
+          maxVisibleSection = section.id;
+        }
+      });
+      
+      // Update title state based on visible section
+      if (maxVisibleSection && sectionTitles[maxVisibleSection]) {
+        setCurrentTitle(sectionTitles[maxVisibleSection]);
+      } else {
+        setCurrentTitle(effectiveDefaultTitle);
+      }
+    };
+    
+    // Add scroll event listener with throttling
+    let isScrolling = false;
+    const handleScroll = () => {
+      if (!isScrolling) {
+        window.requestAnimationFrame(() => {
+          updateTitle();
+          isScrolling = false;
+        });
+        isScrolling = true;
+      }
+    };
+    
+    window.addEventListener('scroll', handleScroll);
+    
+    // Initial call
+    updateTitle();
+    
+    // Clean up
+    return () => {
+      window.removeEventListener('scroll', handleScroll);
+    };
+  }, [location.pathname, sections, effectiveDefaultTitle, enabled]);
+
+  useEffect(() => {
+    if (currentTitle) {
+      document.title = currentTitle;
+    }
+  }, [currentTitle]);
+
+  // Component doesn't render anything visible
+  return null;
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "portosaurus",
+  "version": "1.14.0",
+  "author": "soymadip",
+  "license": "GPL-3.0-only",
+  "description": "Complete portfolio cum personal website solution for your digital personality.",
+  "homepage": "https://github.com/soymadip/portosaurus#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/soymadip/portosaurus.git"
+  },
+  "bugs": {
+    "url": "https://github.com/soymadip/portosaurus/issues"
+  },
+  "keywords": [
+    "portfolio",
+    "docusaurus",
+    "cli",
+    "static-site-generator",
+    "documentation",
+    "blog"
+  ],
+  "type": "module",
+  "bin": {
+    "portosaurus": "bin/portosaurus.js"
+  },
+  "files": [
+    "bin/",
+    "internal/",
+    "template/",
+    "utils/"
+  ],
+  "dependencies": {
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/preset-classic": "^3.9.2",
+    "chalk": "^5.6.2",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.3.3",
+    "prompts": "^2.4.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-icons": "^5.4.0",
+    "react-slick": "^0.30.2",
+    "slick-carousel": "^1.8.1",
+    "clsx": "^2.1.1",
+    "prism-react-renderer": "^2.4.1",
+    "favicons": "^7.2.0",
+    "plugin-image-zoom": "github:flexanalytics/plugin-image-zoom",
+    "@easyops-cn/docusaurus-search-local": "^0.52.1"
+  }
+}

package/template/.github/workflows/deploy.yml

@@ -0,0 +1,57 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Cache Bun dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build site
+        run: bun run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: build/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/template/README.md

@@ -0,0 +1,70 @@
+# 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 start
+
+# With npm
+npm run start
+```
+
+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

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

package/template/blog/welcome.md

@@ -0,0 +1,10 @@
+---
+slug: welcome
+title: Welcome
+authors: [soymadip]
+tags: [hello, portosaurus]
+---
+
+Welcome to your new Portosaurus blog!
+
+This is a sample blog post.

package/template/config.js

@@ -0,0 +1,233 @@
+exports.usrConf = {
+
+  auto_update: true,
+
+  dark_mode: true,
+
+  site_url: "auto",
+  site_path: "auto",
+
+  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/template/notes/getting-started.md

@@ -0,0 +1,7 @@
+---
+sidebar_position: 1
+---
+
+# Getting Started
+
+This is a sample note. You can create your own notes in this directory.