refactor

Author: bufrr

.blogrc.example

@@ -0,0 +1,15 @@
+# Blog configuration example
+# Copy this file to .blogrc and customize
+
+# Blog title
+export BLOG_TITLE="My Awesome Blog"
+
+# Author information
+export BLOG_AUTHOR="Your Name"
+export BLOG_EMAIL="your.email@example.com"
+
+# Enable incremental builds (only rebuild changed files)
+# export INCREMENTAL_BUILD=true
+
+# Additional Emacs load paths (if you have custom elisp packages)
+# export EMACS_LOAD_PATH="/path/to/custom/packages"

build.sh

@@ -5,6 +5,12 @@
 
 set -euo pipefail
 
+# Configuration
+BLOG_TITLE="${BLOG_TITLE:-Noob Notes}"
+BLOG_AUTHOR="${BLOG_AUTHOR:-bytenoob}"
+BLOG_EMAIL="${BLOG_EMAIL:-noreply@example.com}"
+INCREMENTAL_BUILD="${INCREMENTAL_BUILD:-false}"
+
 # Source configuration if available
 if [ -f ".blogrc" ]; then
   # shellcheck source=/dev/null
@@ -18,6 +24,11 @@ NC='\033[0m'
 
 echo -e "${GREEN}Building blog...${NC}"
 
+# Show incremental build option if not enabled
+if [ "$INCREMENTAL_BUILD" != "true" ]; then
+  echo -e "${YELLOW}Tip:${NC} Use INCREMENTAL_BUILD=true $0 to skip unchanged files"
+fi
+
 # Get version numbers for cache busting based on file modification time
 CSS_VERSION=$(stat -c %Y static/css/blog.css 2> /dev/null || stat -f %m static/css/blog.css 2> /dev/null || echo "1")
 JS_VERSION=$(stat -c %Y static/js/blog.js 2> /dev/null || stat -f %m static/js/blog.js 2> /dev/null || echo "1")
@@ -40,6 +51,7 @@ if emacs --batch \
   ;; Set user info (use environment variables for security)
   (setq user-full-name (or (getenv \"BLOG_AUTHOR\") \"bytenoob\"))
   (setq user-mail-address (or (getenv \"BLOG_EMAIL\") \"noreply@example.com\"))
+  (setq blog-title (or (getenv \"BLOG_TITLE\") \"Noob Notes\"))
   
   ;; Load org and ox-publish
   (require 'org)
@@ -94,12 +106,21 @@ if emacs --batch \
      ;; If htmlize fails to load, continue without syntax highlighting
      (message \"Warning: htmlize not available, syntax highlighting disabled\")))
   
+  ;; Common HTML head content
+  (defun blog/html-head ()
+    (concat \"<link rel=\\\"icon\\\" type=\\\"image/svg+xml\\\" href=\\\"/static/favicon.svg\\\">
+<link rel=\\\"preconnect\\\" href=\\\"https://fonts.googleapis.com\\\">
+<link rel=\\\"preconnect\\\" href=\\\"https://fonts.gstatic.com\\\" crossorigin>
+<link href=\\\"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap\\\" rel=\\\"stylesheet\\\">
+<link rel=\\\"stylesheet\\\" type=\\\"text/css\\\" href=\\\"/static/css/blog.css?v=\" (or (getenv \"CSS_VERSION\") \"1\") \"\\\" />
+<script src=\\\"/static/js/blog.js?v=\" (or (getenv \"JS_VERSION\") \"1\") \"\\\" defer></script>\"))
+  
   ;; Custom HTML preamble and postamble
   (defun blog/preamble (info)
     (concat
      \"<header class=\\\"site-header\\\">\"
      \"<div class=\\\"container\\\">\"
-     \"<h1 class=\\\"site-title\\\"><a href=\\\"/\\\">Noob Notes</a></h1>\"
+     \"<h1 class=\\\"site-title\\\"><a href=\\\"/\\\">\" blog-title \"</a></h1>\"
      \"<nav class=\\\"site-nav\\\">\"
      \"<a href=\\\"/\\\">Home</a>\"
      \"<a href=\\\"/about.html\\\">About</a>\"
@@ -130,16 +151,31 @@ if emacs --batch \
       (goto-char (point-min))
       (re-search-forward \"^#\\\\+DRAFT:\\\\s-*\\\\(true\\\\|t\\\\|yes\\\\)\" nil t)))
   
-  ;; Custom publishing function that skips drafts
+  ;; Function to check if file needs rebuilding
+  (defun blog/needs-rebuild-p (org-file html-file)
+    \"Check if ORG-FILE needs to be rebuilt by comparing with HTML-FILE.\"
+    (or (not (file-exists-p html-file))
+        (file-newer-than-file-p org-file html-file)
+        (not (string= (getenv \"INCREMENTAL_BUILD\") \"true\"))))
+  
+  ;; Custom publishing function that skips drafts and unchanged files
   (defun blog/publish-to-html (plist filename pub-dir)
-    \"Publish an org file to HTML, but skip if it's a draft.\"
+    \"Publish an org file to HTML, but skip if it's a draft or unchanged.\"
     (unless (blog/is-draft-p filename)
-      (org-html-publish-to-html plist filename pub-dir)))
+      (let* ((html-file (concat pub-dir 
+                               (file-name-sans-extension 
+                                (file-name-nondirectory filename)) 
+                               \".html\")))
+        (if (blog/needs-rebuild-p filename html-file)
+            (progn
+              (message \"Building: %s\" filename)
+              (org-html-publish-to-html plist filename pub-dir))
+          (message \"Skipping unchanged: %s\" filename)))))
   
   ;; Custom sitemap function to exclude author and draft posts
   (defun blog/sitemap-function (title list)
     \"Generate sitemap as an Org file without author metadata and draft posts.\"
-    (concat \"#+TITLE: Noob Notes\\n\"
+    (concat \"#+TITLE: \" blog-title \"\\n\"
             \"#+AUTHOR:\\n\"
             \"#+OPTIONS: author:nil toc:nil num:nil h:0\\n\\n\"
             (org-list-to-org list)))
@@ -157,12 +193,7 @@ if emacs --batch \
            :with-toc t
            :with-author t
            :with-date t
-           :html-head ,(concat \"<link rel=\\\"icon\\\" type=\\\"image/svg+xml\\\" href=\\\"/static/favicon.svg\\\">
-<link rel=\\\"preconnect\\\" href=\\\"https://fonts.googleapis.com\\\">
-<link rel=\\\"preconnect\\\" href=\\\"https://fonts.gstatic.com\\\" crossorigin>
-<link href=\\\"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap\\\" rel=\\\"stylesheet\\\">
-<link rel=\\\"stylesheet\\\" type=\\\"text/css\\\" href=\\\"/static/css/blog.css?v=\" (or (getenv \"CSS_VERSION\") \"$CSS_VERSION\") \"\\\" />
-<script src=\\\"/static/js/blog.js?v=\" (or (getenv \"JS_VERSION\") \"$JS_VERSION\") \"\\\" defer></script>\")
+           :html-head ,(blog/html-head)
            :html-preamble blog/preamble
            :html-postamble blog/postamble
            :html-head-include-default-style nil
@@ -190,12 +221,7 @@ if emacs --batch \
            :with-toc t
            :with-author t
            :with-date t
-           :html-head ,(concat \"<link rel=\\\"icon\\\" type=\\\"image/svg+xml\\\" href=\\\"/static/favicon.svg\\\">
-<link rel=\\\"preconnect\\\" href=\\\"https://fonts.googleapis.com\\\">
-<link rel=\\\"preconnect\\\" href=\\\"https://fonts.gstatic.com\\\" crossorigin>
-<link href=\\\"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap\\\" rel=\\\"stylesheet\\\">
-<link rel=\\\"stylesheet\\\" type=\\\"text/css\\\" href=\\\"/static/css/blog.css?v=\" (or (getenv \"CSS_VERSION\") \"$CSS_VERSION\") \"\\\" />
-<script src=\\\"/static/js/blog.js?v=\" (or (getenv \"JS_VERSION\") \"$JS_VERSION\") \"\\\" defer></script>\")
+           :html-head ,(blog/html-head)
            :html-preamble blog/preamble
            :html-postamble blog/postamble
            :html-head-include-default-style nil
@@ -224,10 +250,14 @@ if emacs --batch \
 
   # Show build statistics
   if [ -d "public" ]; then
-    POST_COUNT=$(find public -name "*.html" -not -name "index.html" | wc -l)
+    POST_COUNT=$(find public -name "*.html" -not -name "index.html" -not -name "index-cn.html" | wc -l)
     TOTAL_SIZE=$(du -sh public | cut -f1)
     echo -e "${GREEN}Generated:${NC} $POST_COUNT posts"
     echo -e "${GREEN}Total size:${NC} $TOTAL_SIZE"
+    
+    if [ "$INCREMENTAL_BUILD" = "true" ]; then
+      echo -e "${GREEN}Mode:${NC} Incremental build"
+    fi
   fi
 else
   echo -e "${YELLOW}Build completed with warnings${NC}"

static/css/blog.css

@@ -103,11 +103,6 @@ body {
 }
 
 /* Focus styles for accessibility */
-:focus {
-  outline: 2px solid var(--accent-primary);
-  outline-offset: 2px;
-}
-
 /* Remove focus outline for mouse clicks, keep for keyboard */
 :focus:not(:focus-visible) {
   outline: none;
@@ -142,6 +137,11 @@ body {
   }
 }
 
+/* Apply will-change to animated elements */
+.article-meta {
+  will-change: opacity, transform;
+}
+
 /* ===== Layout Components ===== */
 
 /* Container */
@@ -205,11 +205,17 @@ body {
   position: relative;
 }
 
-.site-nav a:hover,
-.site-nav a:focus {
+.site-nav a:hover {
   color: var(--text-primary);
 }
 
+.site-nav a:focus-visible {
+  color: var(--text-primary);
+  outline: 2px solid var(--accent-primary);
+  outline-offset: 2px;
+  border-radius: 4px;
+}
+
 /* Language Switcher */
 .lang-switcher {
   display: flex;
@@ -458,12 +464,18 @@ li strong {
   transition: all 0.15s ease;
 }
 
-#table-of-contents a:hover,
-#table-of-contents a:focus {
+#table-of-contents a:hover {
   background-color: var(--bg-primary);
   color: var(--text-primary);
 }
 
+#table-of-contents a:focus-visible {
+  background-color: var(--bg-primary);
+  color: var(--text-primary);
+  outline: 2px solid var(--accent-primary);
+  outline-offset: -2px;
+}
+
 #table-of-contents a.active {
   background-color: var(--accent-primary);
   color: white;
@@ -559,6 +571,7 @@ pre {
   transition: all 0.2s ease;
   opacity: 0.8;
   z-index: 1;
+  will-change: opacity, transform;
 }
 
 .code-copy-button:hover {
@@ -659,6 +672,7 @@ img {
   text-decoration: none;
   cursor: pointer;
   transition: all 0.2s ease;
+  will-change: transform;
 }
 
 .btn:hover {
@@ -913,84 +927,42 @@ img {
   color: #9c6fcf;
 }
 
-/* General purpose classes that might be used by various modes */
-.org-font-lock-keyword-face {
-  color: #9c6fcf;
-  font-weight: 600;
-}
-
-.org-font-lock-type-face {
-  color: #d4a27f;
-}
-
-.org-font-lock-string-face {
-  color: #86b85c;
-}
-
-.org-font-lock-comment-face {
-  color: #8a8a8a;
-  font-style: italic;
-}
-
-.org-font-lock-function-name-face {
-  color: #5b9bc8;
-  font-weight: 600;
-}
-
-.org-font-lock-variable-name-face {
-  color: #5b9bc8;
-}
-
-.org-font-lock-constant-face {
-  color: #d68b5b;
-}
-
-.org-font-lock-builtin-face {
-  color: #d4a27f;
-}
+/* General purpose classes that might be used by various modes - removed duplicates */
 
 /* Dark mode adjustments */
 @media (prefers-color-scheme: dark) {
-  .org-keyword,
-  .org-font-lock-keyword-face {
+  .org-keyword {
     color: #bb9af7;
   }
 
-  .org-builtin,
-  .org-font-lock-builtin-face {
+  .org-builtin {
     color: #e0af68;
   }
 
-  .org-string,
-  .org-font-lock-string-face {
+  .org-string {
     color: #9ece6a;
   }
 
   .org-comment,
   .org-comment-delimiter,
-  .org-font-lock-comment-face,
   .org-doc,
   .org-doc-keyword {
     color: #565f89;
   }
 
-  .org-function-name,
-  .org-font-lock-function-name-face {
+  .org-function-name {
     color: #7dcfff;
   }
 
-  .org-variable-name,
-  .org-font-lock-variable-name-face {
+  .org-variable-name {
     color: #7aa2f7;
   }
 
-  .org-constant,
-  .org-font-lock-constant-face {
+  .org-constant {
     color: #ff9e64;
   }
 
-  .org-type,
-  .org-font-lock-type-face {
+  .org-type {
     color: #e0af68;
   }