531 lines
32 KiB
HTML
531 lines
32 KiB
HTML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
<title>Setup</title>
|
|
<meta name="generator" content="Org Mode" />
|
|
<style type="text/css">
|
|
#content { max-width: 60em; margin: auto; }
|
|
.title { text-align: center;
|
|
margin-bottom: .2em; }
|
|
.subtitle { text-align: center;
|
|
font-size: medium;
|
|
font-weight: bold;
|
|
margin-top:0; }
|
|
.todo { font-family: monospace; color: red; }
|
|
.done { font-family: monospace; color: green; }
|
|
.priority { font-family: monospace; color: orange; }
|
|
.tag { background-color: #eee; font-family: monospace;
|
|
padding: 2px; font-size: 80%; font-weight: normal; }
|
|
.timestamp { color: #bebebe; }
|
|
.timestamp-kwd { color: #5f9ea0; }
|
|
.org-right { margin-left: auto; margin-right: 0px; text-align: right; }
|
|
.org-left { margin-left: 0px; margin-right: auto; text-align: left; }
|
|
.org-center { margin-left: auto; margin-right: auto; text-align: center; }
|
|
.underline { text-decoration: underline; }
|
|
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
|
|
p.verse { margin-left: 3%; }
|
|
pre {
|
|
border: 1px solid #e6e6e6;
|
|
border-radius: 3px;
|
|
background-color: #f2f2f2;
|
|
padding: 8pt;
|
|
font-family: monospace;
|
|
overflow: auto;
|
|
margin: 1.2em;
|
|
}
|
|
pre.src {
|
|
position: relative;
|
|
overflow: auto;
|
|
}
|
|
pre.src:before {
|
|
display: none;
|
|
position: absolute;
|
|
top: -8px;
|
|
right: 12px;
|
|
padding: 3px;
|
|
color: #555;
|
|
background-color: #f2f2f299;
|
|
}
|
|
pre.src:hover:before { display: inline; margin-top: 14px;}
|
|
/* Languages per Org manual */
|
|
pre.src-asymptote:before { content: 'Asymptote'; }
|
|
pre.src-awk:before { content: 'Awk'; }
|
|
pre.src-authinfo::before { content: 'Authinfo'; }
|
|
pre.src-C:before { content: 'C'; }
|
|
/* pre.src-C++ doesn't work in CSS */
|
|
pre.src-clojure:before { content: 'Clojure'; }
|
|
pre.src-css:before { content: 'CSS'; }
|
|
pre.src-D:before { content: 'D'; }
|
|
pre.src-ditaa:before { content: 'ditaa'; }
|
|
pre.src-dot:before { content: 'Graphviz'; }
|
|
pre.src-calc:before { content: 'Emacs Calc'; }
|
|
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
|
|
pre.src-fortran:before { content: 'Fortran'; }
|
|
pre.src-gnuplot:before { content: 'gnuplot'; }
|
|
pre.src-haskell:before { content: 'Haskell'; }
|
|
pre.src-hledger:before { content: 'hledger'; }
|
|
pre.src-java:before { content: 'Java'; }
|
|
pre.src-js:before { content: 'Javascript'; }
|
|
pre.src-latex:before { content: 'LaTeX'; }
|
|
pre.src-ledger:before { content: 'Ledger'; }
|
|
pre.src-lisp:before { content: 'Lisp'; }
|
|
pre.src-lilypond:before { content: 'Lilypond'; }
|
|
pre.src-lua:before { content: 'Lua'; }
|
|
pre.src-matlab:before { content: 'MATLAB'; }
|
|
pre.src-mscgen:before { content: 'Mscgen'; }
|
|
pre.src-ocaml:before { content: 'Objective Caml'; }
|
|
pre.src-octave:before { content: 'Octave'; }
|
|
pre.src-org:before { content: 'Org mode'; }
|
|
pre.src-oz:before { content: 'OZ'; }
|
|
pre.src-plantuml:before { content: 'Plantuml'; }
|
|
pre.src-processing:before { content: 'Processing.js'; }
|
|
pre.src-python:before { content: 'Python'; }
|
|
pre.src-R:before { content: 'R'; }
|
|
pre.src-ruby:before { content: 'Ruby'; }
|
|
pre.src-sass:before { content: 'Sass'; }
|
|
pre.src-scheme:before { content: 'Scheme'; }
|
|
pre.src-screen:before { content: 'Gnu Screen'; }
|
|
pre.src-sed:before { content: 'Sed'; }
|
|
pre.src-sh:before { content: 'shell'; }
|
|
pre.src-sql:before { content: 'SQL'; }
|
|
pre.src-sqlite:before { content: 'SQLite'; }
|
|
/* additional languages in org.el's org-babel-load-languages alist */
|
|
pre.src-forth:before { content: 'Forth'; }
|
|
pre.src-io:before { content: 'IO'; }
|
|
pre.src-J:before { content: 'J'; }
|
|
pre.src-makefile:before { content: 'Makefile'; }
|
|
pre.src-maxima:before { content: 'Maxima'; }
|
|
pre.src-perl:before { content: 'Perl'; }
|
|
pre.src-picolisp:before { content: 'Pico Lisp'; }
|
|
pre.src-scala:before { content: 'Scala'; }
|
|
pre.src-shell:before { content: 'Shell Script'; }
|
|
pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
|
|
/* additional language identifiers per "defun org-babel-execute"
|
|
in ob-*.el */
|
|
pre.src-cpp:before { content: 'C++'; }
|
|
pre.src-abc:before { content: 'ABC'; }
|
|
pre.src-coq:before { content: 'Coq'; }
|
|
pre.src-groovy:before { content: 'Groovy'; }
|
|
/* additional language identifiers from org-babel-shell-names in
|
|
ob-shell.el: ob-shell is the only babel language using a lambda to put
|
|
the execution function name together. */
|
|
pre.src-bash:before { content: 'bash'; }
|
|
pre.src-csh:before { content: 'csh'; }
|
|
pre.src-ash:before { content: 'ash'; }
|
|
pre.src-dash:before { content: 'dash'; }
|
|
pre.src-ksh:before { content: 'ksh'; }
|
|
pre.src-mksh:before { content: 'mksh'; }
|
|
pre.src-posh:before { content: 'posh'; }
|
|
/* Additional Emacs modes also supported by the LaTeX listings package */
|
|
pre.src-ada:before { content: 'Ada'; }
|
|
pre.src-asm:before { content: 'Assembler'; }
|
|
pre.src-caml:before { content: 'Caml'; }
|
|
pre.src-delphi:before { content: 'Delphi'; }
|
|
pre.src-html:before { content: 'HTML'; }
|
|
pre.src-idl:before { content: 'IDL'; }
|
|
pre.src-mercury:before { content: 'Mercury'; }
|
|
pre.src-metapost:before { content: 'MetaPost'; }
|
|
pre.src-modula-2:before { content: 'Modula-2'; }
|
|
pre.src-pascal:before { content: 'Pascal'; }
|
|
pre.src-ps:before { content: 'PostScript'; }
|
|
pre.src-prolog:before { content: 'Prolog'; }
|
|
pre.src-simula:before { content: 'Simula'; }
|
|
pre.src-tcl:before { content: 'tcl'; }
|
|
pre.src-tex:before { content: 'TeX'; }
|
|
pre.src-plain-tex:before { content: 'Plain TeX'; }
|
|
pre.src-verilog:before { content: 'Verilog'; }
|
|
pre.src-vhdl:before { content: 'VHDL'; }
|
|
pre.src-xml:before { content: 'XML'; }
|
|
pre.src-nxml:before { content: 'XML'; }
|
|
/* add a generic configuration mode; LaTeX export needs an additional
|
|
(add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
|
|
pre.src-conf:before { content: 'Configuration File'; }
|
|
|
|
table { border-collapse:collapse; }
|
|
caption.t-above { caption-side: top; }
|
|
caption.t-bottom { caption-side: bottom; }
|
|
td, th { vertical-align:top; }
|
|
th.org-right { text-align: center; }
|
|
th.org-left { text-align: center; }
|
|
th.org-center { text-align: center; }
|
|
td.org-right { text-align: right; }
|
|
td.org-left { text-align: left; }
|
|
td.org-center { text-align: center; }
|
|
dt { font-weight: bold; }
|
|
.footpara { display: inline; }
|
|
.footdef { margin-bottom: 1em; }
|
|
.figure { padding: 1em; }
|
|
.figure p { text-align: center; }
|
|
.equation-container {
|
|
display: table;
|
|
text-align: center;
|
|
width: 100%;
|
|
}
|
|
.equation {
|
|
vertical-align: middle;
|
|
}
|
|
.equation-label {
|
|
display: table-cell;
|
|
text-align: right;
|
|
vertical-align: middle;
|
|
}
|
|
.inlinetask {
|
|
padding: 10px;
|
|
border: 2px solid gray;
|
|
margin: 10px;
|
|
background: #ffffcc;
|
|
}
|
|
#org-div-home-and-up
|
|
{ text-align: right; font-size: 70%; white-space: nowrap; }
|
|
textarea { overflow-x: auto; }
|
|
.linenr { font-size: smaller }
|
|
.code-highlighted { background-color: #ffff00; }
|
|
.org-info-js_info-navigation { border-style: none; }
|
|
#org-info-js_console-label
|
|
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
|
|
.org-info-js_search-highlight
|
|
{ background-color: #ffff00; color: #000000; font-weight: bold; }
|
|
.org-svg { }
|
|
</style>
|
|
|
|
<link rel="stylesheet" type="text/css" href="https://gongzhitaao.org/orgcss/org.css" />
|
|
<link rel="stylesheet" href="style.css" />
|
|
<script src="script.js" defer></script>
|
|
</head>
|
|
<body>
|
|
<div id="preamble" class="status">
|
|
<nav>
|
|
<a href="/">Home | </a>
|
|
<a href="/posts/posts-list.html">Posts | </a>
|
|
<a href="/blogs/blogs-list.html">Blogs | </a>
|
|
<a href="/contact.html">Contact</a>
|
|
</nav>
|
|
<div id="updated">Updated: 2025-08-07 Thu 22:36</div>
|
|
</div>
|
|
<div id="content" class="content">
|
|
<h1 class="title">Setup</h1>
|
|
<div id="outline-container-org829abdc" class="outline-2">
|
|
<h2 id="org829abdc">Introduction</h2>
|
|
<div class="outline-text-2" id="text-org829abdc">
|
|
<p>
|
|
This page will highlight the <code>build-script.el</code> used to generate this website. This entire website is generated through org files using the command:
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
<pre class="src src-bash">emacs -Q --script build-site.el
|
|
</pre>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div id="outline-container-orgb9cb047" class="outline-2">
|
|
<h2 id="orgb9cb047">The script</h2>
|
|
<div class="outline-text-2" id="text-orgb9cb047">
|
|
<p>
|
|
The script is as follows, at the start I have commented out pieces of code (somewhat relevant to the script but never really used), followed by package management. Then there's the declaration of variables and functions and finally the <code>org-publish-project-alist</code> which handles nearly all of the project generation instructions.
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
<pre class="src src-emacs-lisp">
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Commented out things:
|
|
</span>
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">(defvar z-head
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">"<link rel=\"stylesheet\" type=\"text/css\" href=\"https://gongzhitaao.org/orgcss/org.css\" />
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment"><link rel=\"stylesheet\" href=\"/style.css\" />")
|
|
</span>
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">(setq org-html-validation-link nil
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">org-html-head-include-scripts nil
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">org-html-head-include-default-style nil
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">org-html-head z-head)
|
|
</span>
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">(type-of (car '(rose violet daisy buttercup)))
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">(cadr (assoc "FILETAGS" (org-collect-keywords '("FILETAGS"))))
|
|
</span>
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">(let ((list '(("post1.org") ("post2.org"))))
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">(mapconcat (lambda (entry)
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">(format "- [[file:%s]]" (car entry)))
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">list
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">"\n"))
|
|
</span>
|
|
|
|
|
|
<span class="org-comment-delimiter">;;</span><span class="org-comment">BEGIN:
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">Set the package installation directory so that packages aren't stored in the
|
|
</span><span class="org-comment-delimiter">;; </span><span class="org-comment">~/.emacs.d/elpa path.
|
|
</span>(<span class="org-keyword">require</span> '<span class="org-constant">package</span>)
|
|
(<span class="org-keyword">setq</span> package-user-dir (expand-file-name <span class="org-string">"./.packages"</span>))
|
|
(<span class="org-keyword">setq</span> package-archives '((<span class="org-string">"melpa"</span> . <span class="org-string">"https://melpa.org/packages/"</span>)
|
|
(<span class="org-string">"elpa"</span> . <span class="org-string">"https://elpa.gnu.org/packages/"</span>)))
|
|
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Initialize the package system
|
|
</span>(package-initialize)
|
|
(<span class="org-keyword">unless</span> package-archive-contents
|
|
(package-refresh-contents))
|
|
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Install dependencies
|
|
</span>(package-install 'htmlize)
|
|
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Load the publishing system
|
|
</span>(<span class="org-keyword">require</span> '<span class="org-constant">ox-publish</span>)
|
|
(<span class="org-keyword">setq</span> org-html-htmlize-output-type 'css)
|
|
|
|
(<span class="org-keyword">defvar</span> <span class="org-variable-name">z-preamble</span>
|
|
<span class="org-string">"<nav>
|
|
<a href=\"/\">Home | </a>
|
|
<a href=\"/posts/posts-list.html\">Posts | </a>
|
|
<a href=\"/blogs/blogs-list.html\">Blogs | </a>
|
|
<a href=\"/contact.html\">Contact</a>
|
|
</nav>
|
|
<div id=\"updated\">Updated: %C</div>"</span>
|
|
)
|
|
|
|
(<span class="org-keyword">defvar</span> <span class="org-variable-name">z-postamble</span>
|
|
<span class="org-string">"<footer>
|
|
<div class=\"copyright-container\">
|
|
<div class=\"copyright\">
|
|
Copyright &copy; 2022-2025 Zaine Qayyum. All rights reserved unless otherwise noted.</div></div>
|
|
<div class=\"generated\">
|
|
Created with %c on <a href=\"https://www.archlinux.org/\">Arch</a> <a href=\"https://www.gnu.org\">GNU</a>/<a href=\"https://www.kernel.org/\">Linux</a>
|
|
</div>
|
|
</footer>"</span>)
|
|
|
|
|
|
|
|
(<span class="org-keyword">defun</span> <span class="org-function-name">z/posts-sitemap</span> (title list)
|
|
<span class="org-doc">"sitemap that lists post links as bullet points with dates and tags."</span>
|
|
(concat
|
|
<span class="org-string">"#+TITLE: "</span> title <span class="org-string">"\n"</span>
|
|
<span class="org-string">"#+OPTIONS: toc:nil num:nil \n\n"</span>
|
|
<span class="org-string">"* Posts:\n"</span>
|
|
(mapconcat
|
|
(<span class="org-keyword">lambda</span> (entry)
|
|
(<span class="org-keyword">let*</span> ((link (car entry))
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">extract relative file name from the link
|
|
</span> (filename (<span class="org-keyword">if</span> (string-match <span class="org-string">"\\[\\[file:</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">(</span></span><span class="org-string">[</span><span class="org-string"><span class="org-negation-char">^</span></span><span class="org-string">]]+</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">)</span></span><span class="org-string">\\]"</span> link)
|
|
(match-string 1 link)
|
|
link))
|
|
(full-path (expand-file-name filename <span class="org-string">"~/master-folder/org_files/org_web/posts/"</span>))
|
|
(date-str <span class="org-string">"no date"</span>)
|
|
(tags-str <span class="org-string">""</span>))
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Get publish date
|
|
</span> (<span class="org-keyword">let</span> ((date (org-publish-find-date full-path org-publish-project-alist)))
|
|
(<span class="org-keyword">when</span> date
|
|
(<span class="org-keyword">setq</span> date-str (format-time-string <span class="org-string">"%Y-%m-%d"</span> date))))
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Get FILETAGS from file buffer
|
|
</span> (<span class="org-keyword">when</span> (file-exists-p full-path)
|
|
(<span class="org-keyword">with-temp-buffer</span>
|
|
(insert-file-contents full-path)
|
|
(org-mode)
|
|
(<span class="org-keyword">let*</span> ((tags (cadr (assoc <span class="org-string">"FILETAGS"</span> (org-collect-keywords '(<span class="org-string">"FILETAGS"</span>))))))
|
|
(<span class="org-keyword">when</span> tags
|
|
(<span class="org-keyword">setq</span> tags-str (mapconcat (<span class="org-keyword">lambda</span> (tag)
|
|
(format <span class="org-string">"@@html:<span class=\"post-tag\">%s</span>@@"</span> tag))
|
|
(split-string tags <span class="org-string">":"</span> t) <span class="org-comment-delimiter">;; </span><span class="org-comment"><- Splits by ":" and removes empty strings
|
|
</span> <span class="org-string">" "</span>))))))
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Final line output
|
|
</span> (format <span class="org-string">"- %s @@html:<span class=\"post-date\">%s</span>@@ %s"</span> link date-str tags-str)))
|
|
(cdr list)
|
|
<span class="org-string">"\n"</span>)))
|
|
|
|
|
|
(<span class="org-keyword">defun</span> <span class="org-function-name">z/blogs-sitemap</span> (title list)
|
|
<span class="org-doc">"sitemap that lists blog links as bullet points with dates and tags."</span>
|
|
(concat
|
|
<span class="org-string">"#+TITLE: "</span> title <span class="org-string">"\n"</span>
|
|
<span class="org-string">"#+OPTIONS: toc:nil num:nil \n\n"</span>
|
|
<span class="org-string">"* Posts:\n"</span>
|
|
(mapconcat
|
|
(<span class="org-keyword">lambda</span> (entry)
|
|
(<span class="org-keyword">let*</span> ((link (car entry))
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">extract relative file name from the link
|
|
</span> (filename (<span class="org-keyword">if</span> (string-match <span class="org-string">"\\[\\[file:</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">(</span></span><span class="org-string">[</span><span class="org-string"><span class="org-negation-char">^</span></span><span class="org-string">]]+</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">)</span></span><span class="org-string">\\]"</span> link)
|
|
(match-string 1 link)
|
|
link))
|
|
(full-path (expand-file-name filename <span class="org-string">"~/master-folder/org_files/org_web/blogs/"</span>))
|
|
(date-str <span class="org-string">"no date"</span>)
|
|
(tags-str <span class="org-string">""</span>))
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Get publish date
|
|
</span> (<span class="org-keyword">let</span> ((date (org-publish-find-date full-path org-publish-project-alist)))
|
|
(<span class="org-keyword">when</span> date
|
|
(<span class="org-keyword">setq</span> date-str (format-time-string <span class="org-string">"%Y-%m-%d"</span> date))))
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Get FILETAGS from file buffer
|
|
</span> (<span class="org-keyword">when</span> (file-exists-p full-path)
|
|
(<span class="org-keyword">with-temp-buffer</span>
|
|
(insert-file-contents full-path)
|
|
(org-mode)
|
|
(<span class="org-keyword">let*</span> ((tags (cadr (assoc <span class="org-string">"FILETAGS"</span> (org-collect-keywords '(<span class="org-string">"FILETAGS"</span>))))))
|
|
(<span class="org-keyword">when</span> tags
|
|
(<span class="org-keyword">setq</span> tags-str (mapconcat (<span class="org-keyword">lambda</span> (tag)
|
|
(format <span class="org-string">"@@html:<span class=\"post-tag\">%s</span>@@"</span> tag))
|
|
(split-string tags <span class="org-string">":"</span> t) <span class="org-comment-delimiter">;; </span><span class="org-comment"><- Splits by ":" and removes empty strings
|
|
</span> <span class="org-string">" "</span>))))))
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Final line output
|
|
</span> (format <span class="org-string">"- %s @@html:<span class=\"post-date\">%s</span>@@ %s"</span> link date-str tags-str)))
|
|
(cdr list)
|
|
<span class="org-string">"\n"</span>)))
|
|
|
|
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Define the publishing project
|
|
</span>(<span class="org-keyword">setq</span> org-publish-project-alist
|
|
`((<span class="org-string">"org-notes"</span>
|
|
<span class="org-builtin">:recursive</span> t
|
|
<span class="org-builtin">:base-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/"</span>
|
|
<span class="org-builtin">:publishing-function</span> org-html-publish-to-html
|
|
<span class="org-builtin">:publishing-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/output"</span>
|
|
<span class="org-builtin">:with-author</span> nil
|
|
<span class="org-builtin">:with-creator</span> t
|
|
<span class="org-builtin">:with-toc</span> t
|
|
<span class="org-builtin">:base-extension</span> <span class="org-string">"org"</span>
|
|
<span class="org-builtin">:section-numbers</span> nil
|
|
<span class="org-builtin">:time-stamp-file</span> nil
|
|
<span class="org-builtin">:html-preamble</span> ,z-preamble
|
|
<span class="org-builtin">:html-postamble</span> ,z-postamble
|
|
<span class="org-builtin">:html-head</span> <span class="org-string">"
|
|
<link rel=\"stylesheet\" type=\"text/css\" href=\"https://gongzhitaao.org/orgcss/org.css\" />
|
|
<link rel=\"stylesheet\" href=\"style.css\" />
|
|
<script src=\"script.js\" defer></script>
|
|
"</span>
|
|
)
|
|
(<span class="org-string">"org-posts"</span>
|
|
<span class="org-builtin">:base-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/posts"</span>
|
|
<span class="org-builtin">:base-extension</span> <span class="org-string">"org"</span>
|
|
<span class="org-builtin">:publishing-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/output/posts/"</span>
|
|
<span class="org-builtin">:recursive</span> t
|
|
<span class="org-builtin">:base-extension</span> <span class="org-string">"org"</span>
|
|
<span class="org-builtin">:publishing-function</span> org-html-publish-to-html
|
|
<span class="org-builtin">:with-author</span> nil
|
|
<span class="org-builtin">:with-creator</span> nil
|
|
<span class="org-builtin">:html-validation-link</span> nil
|
|
<span class="org-builtin">:with-toc</span> t
|
|
<span class="org-builtin">:section-numbers</span> t
|
|
<span class="org-builtin">:html-preamble</span> ,z-preamble
|
|
<span class="org-builtin">:html-postamble</span> ,z-postamble
|
|
<span class="org-builtin">:auto-sitemap</span> t
|
|
<span class="org-builtin">:sitemap-filename</span> <span class="org-string">"posts-list.org"</span>
|
|
<span class="org-builtin">:sitemap-title</span> <span class="org-string">"Posts List"</span>
|
|
<span class="org-builtin">:sitemap-style</span> list
|
|
<span class="org-builtin">:sitemap-function</span> z/posts-sitemap
|
|
<span class="org-builtin">:html-head</span> <span class="org-string">"
|
|
<link rel=\"stylesheet\" type=\"text/css\" href=\"https://gongzhitaao.org/orgcss/org.css\" />
|
|
<link rel=\"stylesheet\" href=\"../style.css\" />
|
|
<script src=\"../script.js\" defer></script>
|
|
"</span>
|
|
)
|
|
(<span class="org-string">"org-blogs"</span>
|
|
<span class="org-builtin">:base-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/blogs"</span>
|
|
<span class="org-builtin">:base-extension</span> <span class="org-string">"org"</span>
|
|
<span class="org-builtin">:publishing-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/output/blogs/"</span>
|
|
<span class="org-builtin">:recursive</span> t
|
|
<span class="org-builtin">:base-extension</span> <span class="org-string">"org"</span>
|
|
<span class="org-builtin">:publishing-function</span> org-html-publish-to-html
|
|
<span class="org-builtin">:with-author</span> nil
|
|
<span class="org-builtin">:with-creator</span> nil
|
|
<span class="org-builtin">:html-validation-link</span> nil
|
|
<span class="org-builtin">:with-toc</span> t
|
|
<span class="org-builtin">:section-numbers</span> t
|
|
<span class="org-builtin">:html-preamble</span> ,z-preamble
|
|
<span class="org-builtin">:html-postamble</span> ,z-postamble
|
|
<span class="org-builtin">:auto-sitemap</span> t
|
|
<span class="org-builtin">:sitemap-filename</span> <span class="org-string">"blogs-list.org"</span>
|
|
<span class="org-builtin">:sitemap-title</span> <span class="org-string">"Blogs List"</span>
|
|
<span class="org-builtin">:sitemap-style</span> list
|
|
<span class="org-builtin">:sitemap-function</span> z/blogs-sitemap
|
|
<span class="org-builtin">:html-head</span> <span class="org-string">"
|
|
<link rel=\"stylesheet\" type=\"text/css\" href=\"https://gongzhitaao.org/orgcss/org.css\" />
|
|
<link rel=\"stylesheet\" href=\"../style.css\" />
|
|
<script src=\"../script.js\" defer></script>
|
|
"</span>
|
|
)
|
|
|
|
|
|
(<span class="org-string">"org-assets"</span>
|
|
<span class="org-builtin">:base-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/assets/"</span>
|
|
<span class="org-builtin">:base-extension</span> <span class="org-string">"css</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">js</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">png</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">jpg</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">gif</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">svg</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">pdf</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">woff</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">woff2</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">ttf"</span>
|
|
<span class="org-builtin">:publishing-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/output/assets/"</span>
|
|
<span class="org-builtin">:recursive</span> t
|
|
<span class="org-builtin">:publishing-function</span> org-publish-attachment)
|
|
(<span class="org-string">"org-static"</span>
|
|
<span class="org-builtin">:base-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/"</span>
|
|
<span class="org-builtin">:base-extension</span> <span class="org-string">"css</span><span class="org-string"><span class="org-regexp-grouping-backslash">\\</span></span><span class="org-string"><span class="org-regexp-grouping-construct">|</span></span><span class="org-string">js"</span>
|
|
<span class="org-builtin">:publishing-directory</span> <span class="org-string">"~/master-folder/org_files/org_web/output"</span>
|
|
<span class="org-builtin">:recursive</span> t
|
|
<span class="org-builtin">:publishing-function</span> org-publish-attachment)
|
|
|
|
(<span class="org-string">"website"</span>
|
|
<span class="org-builtin">:components</span> (<span class="org-string">"org-notes"</span> <span class="org-string">"org-assets"</span> <span class="org-string">"org-posts"</span> <span class="org-string">"org-blogs"</span> <span class="org-string">"org-static"</span>))))
|
|
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Delete the output before generating the new one
|
|
</span>(delete-directory <span class="org-string">"~/master-folder/org_files/org_web/output/"</span> t)
|
|
(message <span class="org-string">"Directory deleted"</span>)
|
|
|
|
<span class="org-comment-delimiter">;; </span><span class="org-comment">Generate the site output
|
|
</span>(org-publish-all t)
|
|
|
|
(message <span class="org-string">"Build complete!"</span>)
|
|
|
|
</pre>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div id="outline-container-org9d45ee3" class="outline-2">
|
|
<h2 id="org9d45ee3">Publish Script</h2>
|
|
<div class="outline-text-2" id="text-org9d45ee3">
|
|
<p>
|
|
As the project is hosted on Github, I have created a small script that is able to push changes to the remote repository, which Cloudflare will automatically detect and rebuild the website:
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
<pre class="src src-bash">
|
|
<span class="org-comment-delimiter">#</span><span class="org-comment">!/bin/bash
|
|
</span>
|
|
<span class="org-comment-delimiter"># </span><span class="org-comment">Exit immediately if any command fails
|
|
</span><span class="org-builtin">set</span> -e
|
|
|
|
<span class="org-comment-delimiter"># </span><span class="org-comment">Define paths
|
|
</span><span class="org-variable-name">ORG_PROJECT_NAME</span>=<span class="org-string">"website"</span>
|
|
<span class="org-variable-name">ORG_OUTPUT_DIR</span>=<span class="org-string">"$HOME/master-folder/org_files/org_web/output"</span>
|
|
|
|
<span class="org-comment-delimiter"># </span><span class="org-comment">commands used prior to having the `build-script.el`
|
|
</span><span class="org-comment-delimiter"># </span><span class="org-comment">echo "Running org-publish..."
|
|
</span><span class="org-comment-delimiter"># </span><span class="org-comment">emacs --batch \
|
|
</span><span class="org-comment-delimiter"># </span><span class="org-comment">--eval "(require 'org)" \
|
|
</span><span class="org-comment-delimiter"># </span><span class="org-comment">--eval "(require 'ox-publish)" \
|
|
</span><span class="org-comment-delimiter"># </span><span class="org-comment">--eval "(org-publish \"$ORG_PROJECT_NAME\" t)"
|
|
</span>
|
|
<span class="org-builtin">cd</span> <span class="org-string">"$ORG_OUTPUT_DIR"</span>
|
|
|
|
<span class="org-builtin">echo</span> <span class="org-string">"HTML published to: $ORG_OUTPUT_DIR"</span>
|
|
|
|
<span class="org-comment-delimiter"># </span><span class="org-comment">Git commands
|
|
</span><span class="org-builtin">echo</span> <span class="org-string">"Adding changes to Git..."</span>
|
|
git add .
|
|
|
|
<span class="org-builtin">echo</span> <span class="org-string">"Committing..."</span>
|
|
git commit -m <span class="org-string">"Auto-publish on $(date)"</span> || <span class="org-builtin">echo</span> <span class="org-string">"Nothing to commit."</span>
|
|
|
|
<span class="org-builtin">echo</span> <span class="org-string">"Pushing to GitHub..."</span>
|
|
git push origin main
|
|
|
|
<span class="org-builtin">echo</span> <span class="org-string">"Done! Changes pushed and Cloudflare should rebuild the site."</span>
|
|
|
|
</pre>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div id="postamble" class="status">
|
|
<footer>
|
|
<div class="copyright-container">
|
|
<div class="copyright">
|
|
Copyright © 2022-2025 Zaine Qayyum. All rights reserved unless otherwise noted.</div></div>
|
|
<div class="generated">
|
|
Created with <a href="https://www.gnu.org/software/emacs/">Emacs</a> 30.1 (<a href="https://orgmode.org">Org</a> mode 9.7.11) on <a href="https://www.archlinux.org/">Arch</a> <a href="https://www.gnu.org">GNU</a>/<a href="https://www.kernel.org/">Linux</a>
|
|
</div>
|
|
</footer>
|
|
</div>
|
|
</body>
|
|
</html>
|