dotfolio-theme 0.1.0

data/lib/dotfolio-theme/installer.rb

@@ -0,0 +1,42 @@
+require "fileutils"
+
+module DotfolioTheme
+  class Installer
+    TEMPLATE_DIR = File.expand_path("templates", __dir__)
+
+    def self.install
+      files_to_copy = ["about.markdown", "search.json", "_config.yml"]
+
+      files_to_copy.each do |filename|
+        src_file = File.join(TEMPLATE_DIR, filename)
+        dest_file = File.join(Dir.pwd, filename)
+
+        if File.exist?(dest_file)
+          print "Warning: #{filename} already exists. Overwrite? (Y/N): "
+          answer = $stdin.gets.chomp.strip.downcase
+          next unless answer == "y"
+        end
+
+        FileUtils.cp(src_file, dest_file)
+        puts "#{filename} installed!"
+      end
+
+      # Create notes directory
+      notes_dir = File.join(Dir.pwd, "notes")
+      FileUtils.mkdir_p(notes_dir)
+
+      # Copy index.html into notes/
+      src_index = File.join(TEMPLATE_DIR, "notes-index.html")
+      dest_index = File.join(notes_dir, "index.html")
+
+      if File.exist?(dest_index)
+        print "Warning: notes/index.html already exists. Overwrite? (Y/N): "
+        answer = $stdin.gets.chomp.strip.downcase
+        return unless answer == "y"
+      end
+
+      FileUtils.cp(src_index, dest_index)
+      puts "notes/index.html installed!"
+    end
+  end
+end

data/lib/dotfolio-theme/templates/_config.yml

@@ -0,0 +1,101 @@
+title: Dotfolio
+description: A dotted notebook-style Jekyll theme for minimal and structured developer portfolios.
+
+hero:
+  name: Brainy Smurf
+  title: Curious Engineer
+  location: Smurf Village of Innovation
+  bio: I smurf in crafting the most clever, tidy, and delightfully smurfy solutions in all of Smurf Village. With my superior smurfing methods and impeccable smurf-logic, I ensure everything is organized, efficient, and properly smurfed to perfection.
+
+headings:
+  projects:
+    heading: Projects
+    subheading: A smurfy mix of freelance, volunteer, and passion smurfjects.
+    more:
+      label: More on GitHub
+      link: https://github.com/username
+  posts:
+    heading: Recent Notes
+    subheading: Smurfy notes, bookmarks, and handy smurfources.
+    more:
+      label: Older notes
+
+tools:
+  - name: HTML5
+    icon: /assets/icons/html5.svg
+  - name: CSS3
+    icon: /assets/icons/css.svg
+  - name: JavaScript
+    icon: /assets/icons/javascript.svg
+  - name: Bootstrap
+    icon: /assets/icons/bootstrap.svg
+  - name: Tailwind
+    icon: /assets/icons/tailwind.svg
+  - name: PHP
+    icon: /assets/icons/php.svg
+  - name: MySQL
+    icon: /assets/icons/mysql.svg
+  - name: Postgres
+    icon: /assets/icons/postgresql.svg
+  - name: Python
+    icon: /assets/icons/python.svg
+  - name: Django
+    icon: /assets/icons/django.svg
+  - name: Symfony
+    icon: /assets/icons/symfony.svg
+  - name: Ruby on Rails
+    icon: /assets/icons/rubyonrails.svg
+  - name: Angular
+    icon: /assets/icons/angular.svg
+  - name: GatsbyJS
+    icon: /assets/icons/gatsbyjs.svg  
+  - name: Jekyll
+    icon: /assets/icons/jekyll.svg
+  - name: Heroku
+    icon: /assets/icons/heroku.svg
+  - name: Netlify
+    icon: /assets/icons/netlify.svg
+  - name: Git
+    icon: /assets/icons/git.svg
+  - name: Docker
+    icon: /assets/icons/docker.svg
+  - name: Visual Studio
+    icon: /assets/icons/vscode.svg
+  - name: Jira
+    icon: /assets/icons/jira.svg
+
+projects:
+  - title : Smurfboard
+    description: A smurfy app to keep track of all village tasks, from mushroom gardening to potion brewing.
+    link: https://example.com
+    image: assets/projects/project.png
+  - title : SmurfLib
+    description: A magical collection of scrolls, recipes, and Smurf lore, for every Smurf to learn and share.
+    link: https://example.com
+    image: assets/projects/project.png
+
+socials:
+  - name: GitHub
+    url: https://github.com/yourusername
+    icon: /assets/icons/github.svg
+
+  - name: Instagram
+    url: https://instagram.com/yourusername
+    icon: /assets/icons/instagram.svg
+    
+  - name: LinkedIn
+    url: https://linkedin.com/in/yourusername
+    icon: /assets/icons/linkedin.svg
+
+theme: dotfolio-theme
+
+plugins:
+  - jekyll-paginate-v2
+
+pagination:
+  enabled: true
+  per_page: 5
+  permalink: '/notes/:num/'
+  title: ':title - page :num'
+  sort_field: 'date'
+  sort_reverse: true

data/lib/dotfolio-theme/templates/about.markdown

@@ -0,0 +1,75 @@
+---
+layout: page
+title: About Dotfolio
+permalink: /about/
+---
+
+# 📘 Dotfolio
+
+> A calm, dotted notebook-style Jekyll theme with a minimal, structured layout for showcasing projects and documenting ideas.
+
+---
+
+
+## ✨ Features
+
+- 🧭 Simple, focused homepage layout  
+- 📝 Notes system with **pagination + search**  
+- 🗂 Centralized configuration via a single YAML file  
+- ✍️ Consistent styling across Markdown and HTML  
+- 🌗 Dark mode / light mode toggle  
+- ⚡ Installer script for quick setup  
+- 📦 Fully static (no runtime dependencies)  
+- 🪶 Lightweight and fast  
+- 🔓 Open source  
+
+---
+
+## 📄 Pages
+
+### 🏠 Home
+- Hero section (name tag + short intro)  
+- Tech stack overview  
+- Recent projects (with GitHub profile link)  
+- Recent notes  
+
+### 📝 Notes
+- Paginated index  
+- Built-in search (non-paginated results)  
+
+### 👤 About
+- Dedicated page to introduce yourself  
+
+---
+
+## 🎯 Use Cases
+
+Dotfolio is ideal for:
+
+- Developer portfolios
+- Project showcases
+- Personal blogs
+- Digital gardens / notes
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!
+
+Feel free to:
+- [Open an issue](https://github.com/jennieablog/dotfolio-theme/contribute)
+- [Submit a pull request](https://github.com/jennieablog/dotfolio-theme/pulls)
+
+---
+
+## 📄 License
+
+MIT License © Jennie Ron Ablog
+
+---
+
+## 💡 Acknowledgements
+
+- Built with ❤️ using [Jekyll](https://jekyllrb.com).
+- Styled using [Tailwind CSS](https://tailwindcss.com) during development, then compiled into a standalone stylesheet for production.

data/lib/dotfolio-theme/templates/notes-index.html

@@ -0,0 +1,38 @@
+---
+layout: search
+title: "Notes"
+pagination:
+  enabled: true
+---
+<section class="notes-index">
+  <div class="heading">Notes</div>
+  <p class="subheading">Developer notes, bookmarks, and resources.</p>
+
+  <input type="text" id="search-input" class="search-input" placeholder="Search notes..." />
+
+  <ul id="search-results" class="search-results"></ul>
+  <div id="paginated-posts" class="paginated-posts">
+    <ul>
+      {% for post in paginator.posts %}
+        <li>
+          <h3>
+            <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
+          </h3>
+          <p>
+            {{ post.excerpt | strip_html | truncate: 160 }}
+          </p>
+          <small>{{ post.date | date: "%B %-d, %Y" }}</small>
+        </li>
+      {% endfor %}
+    </ul>
+    <div id="pagination-links" class="pagination">
+    {% if paginator.previous_page %}
+    <a href="{{ paginator.previous_page_path | relative_url }}">&larr; Newer notes</a>
+    {% endif %}
+    {% if paginator.next_page %}
+    <a href="{{ paginator.next_page_path | relative_url }}">Older notes &rarr;</a>
+    {% endif %}
+    </div>
+  </div>
+  <script type="text/javascript" src="{{ '/assets/js/search.js' | relative_url }}"></script>
+</section>

data/lib/dotfolio-theme/templates/search.json

@@ -0,0 +1,13 @@
+---
+layout: null
+---
+[
+  {% for post in site.posts %}
+    {
+      "title": {{ post.title | jsonify }},
+      "url": {{ post.url | relative_url | jsonify }},
+      "excerpt": {{ post.excerpt | strip_html | strip_newlines | jsonify }},
+      "date": "{{ post.date | date: "%B %-d, %Y" }}"
+    }{% unless forloop.last %},{% endunless %}
+  {% endfor %}
+]

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: dotfolio-theme
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jennie Ron Ablog
+bindir: bin
+cert_chain: []
+date: 2026-04-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: jekyll-paginate-v2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Dotfolio is a calm, dotted notebook-style Jekyll theme with a minimal,
+  structured layout for showcasing projects and documenting ideas.
+email:
+- hello@jennieablog.dev
+executables:
+- dotfolio-theme
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- LICENSE.txt
+- README.md
+- _data/theme.yml
+- _includes/footer.html
+- _includes/head.html
+- _includes/hero.html
+- _includes/nav.html
+- _includes/projects.html
+- _includes/recent-posts.html
+- _layouts/default.html
+- _layouts/home.html
+- _layouts/page.html
+- _layouts/post.html
+- _layouts/search.html
+- assets/css/main.css
+- assets/css/tailwind.css
+- assets/icons/angular.svg
+- assets/icons/bootstrap.svg
+- assets/icons/css.svg
+- assets/icons/django.svg
+- assets/icons/docker.svg
+- assets/icons/gatsbyjs.svg
+- assets/icons/git.svg
+- assets/icons/github.svg
+- assets/icons/heroku.svg
+- assets/icons/html5.svg
+- assets/icons/instagram.svg
+- assets/icons/javascript.svg
+- assets/icons/jekyll.svg
+- assets/icons/jira.svg
+- assets/icons/linkedin.svg
+- assets/icons/mysql.svg
+- assets/icons/netlify.svg
+- assets/icons/php.svg
+- assets/icons/postgresql.svg
+- assets/icons/python.svg
+- assets/icons/rubyonrails.svg
+- assets/icons/symfony.svg
+- assets/icons/tailwind.svg
+- assets/icons/twitter.svg
+- assets/icons/vscode.svg
+- assets/images/about.txt
+- assets/images/android-chrome-192x192.png
+- assets/images/android-chrome-512x512.png
+- assets/images/apple-touch-icon.png
+- assets/images/favicon-16x16.png
+- assets/images/favicon-32x32.png
+- assets/images/favicon.ico
+- assets/images/profile.jpg
+- assets/images/site.webmanifest
+- assets/js/search.js
+- assets/js/theme-switcher.js
+- assets/projects/project.png
+- bin/dotfolio-theme
+- lib/dotfolio-theme/installer.rb
+- lib/dotfolio-theme/templates/_config.yml
+- lib/dotfolio-theme/templates/about.markdown
+- lib/dotfolio-theme/templates/notes-index.html
+- lib/dotfolio-theme/templates/search.json
+homepage: https://github.com/jennieablog/dotfolio-theme
+licenses:
+- MIT
+metadata:
+  jekyll-theme: 'true'
+  homepage_uri: https://github.com/jennieablog/dotfolio-theme
+  source_code_uri: https://github.com/jennieablog/dotfolio-theme
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: A dotted notebook-style Jekyll theme for minimal and structured developer
+  portfolios.
+test_files: []