silent 2.0

Be a silent, static blog

for silent 1.0, check this out

Features

Old-school & Clean

• [x] no MVVM frameworks (no vue, react, etc)
• [x] no CCS frameworks
• [ ] no jquery

Static & Portable

• [x] no node_modules (no dependencies, etc)
• [x] no build systems (no gulp, webpack, etc)
• [x] no extra build commands (no npm-run-build or -generate)
• [x] no CI/CD required (github-actions can be optional)
• [x] source code is all it needs to run
• [x] npm-create tooling

Writing, Focus and Visualization

• [x] markdown
• [x] mermaid diagrams

Extendable & Integration

• [x] analytics: google, baidu, etc
• [x] comment system: disqus +cusdis +giscus, etc
• [ ] backend permission api

Funny & Fancy & Performance

• [x] prefer history.pushState api
• [x] progress bar on top
• [x] auto favicon (extracted from title)
• [x] favicon dark mode
• [ ] page-level dark mode

Security & Stability

• [x] responsive design
• [x] prefer es5 and guarded with eslint
• [ ] fallback on browser compatibility break
• [ ] IE 6+ support (needs polyfill, etc)

Usage

# create it
npm create silent <dest>
# or
npm i -g silent
silent create <dest>

# e.g.
npm create silent ~/t/my-blog
# >>>
# copying /Users/fritx/.nvm/versions/node/v16.14.0/lib/node_modules/silent/blog
#  => /Users/fritx/t/my-blog
# silent-create completed

# serve it
cd ~/t/my-blog
npx serve . -p 3000
# >>>
# Serving! http://localhost:3000

# deploy to your github pages?
cd ~/t/my-blog
git init
git remote add origin git@github.com:fritx/silent.git
npx gh-pages -d .
# >>>
# Published. https://fritx.github.io/silent/

Browser Compatibility

Status: no IE

• [ ] no IE https://caniuse.com/?search=arr%20includes
• [ ] no IE https://caniuse.com/?search=str%20includes
• [ ] no IE https://caniuse.com/?search=builtin%20object%20assign
• [ ] IE10+ https://caniuse.com/?search=console
• [x] IE10+ https://caniuse.com/?search=pushstate
• [ ] IE9+ https://caniuse.com/?search=object.keys
• [ ] IE9+ https://caniuse.com/?search=arr%20foreach
• [ ] IE9+ https://caniuse.com/?search=querySelector
• [ ] IE9+ https://caniuse.com/?search=css3%20selectors
• [x] IE8+ https://caniuse.com/?search=scrollintoview

mermaid:

• [ ] no IE https://caniuse.com/?search=arrow%20function

auto title favicon:

• [x] no IE https://caniuse.com/?search=prefers-color-scheme
• [x] IE10+ https://caniuse.com/?search=matchMedia
• [ ] IE9+ https://caniuse.com/?search=canvas

if using giscus:

• [ ] no IE https://caniuse.com/?search=ResizeObserver
• [ ] IE8+ https://caniuse.com/?search=postmessage
• [ ] IE8+ https://caniuse.com/?search=localstorage

Silent Fans

Thank you!

• ZhanZengyu's Blog
• Meizhuo's Blog
• Amen's Blog
• Jayin's Blog
• Derek's Blog
• Huang's Blog
• Jason's Blog
• Jayden's Blog
• Fritx' Blog

More..

Rather than a framework or library, silent is more like a spirit - a culture. (says Huang)

• Silent One Year Old
• Silent T-Shirt

Changelog

• v0.1.2 (06/07)

  1. fix resolve: ignore trailing slash
  2. update font-family & code block style
  3. upgrade gulp-deps & eslint
  4. update readme

• v0.1.1 (12/19)

  1. no longer a cmd tool
  2. no longer a node lib
  3. update deps & fix eslint
  4. recommend using prj to init

• v0.1.0 (06/18)

  1. fix local link target
  2. no-semicolon style

• v0.0.9-5 (06/02)

  1. fix /usr/bin/env bug
  2. use strict and eol
  3. include dependencies gulp/eslint/eol

• v0.0.9-4 (05/31)

  1. set bg-color to white
  2. sans-serif instead for pre/code
  3. search for mainTitle in h1~h6
  4. configurable container selectors
  5. move to CHANGELOG.md

• v0.0.9-3 (05/29)

  1. add index.js for usage as local module
  2. slashes vars in regex
  3. support hash with local links

• v0.0.9-2 (05/24)

  1. fix empty resolved href by .
  2. optional disqus() and comments()
  3. better access for config() and start()

• v0.0.9-1 (05/22)

  1. remove space caused by \n in p tags
  2. add path resolve against ../ or ./
  3. not reload on default page not found

• v0.0.8 (05/20)

  1. add optional disqus support
  2. flag data-loaded for local saved page
  3. use percentage for font-size instead of px
  4. make sure target is a directory (cli)

• v0.0.7 (05/12)

  1. try font "Microsoft YaHei" for chinese on windows
  2. add image holder for shared links (apps like wechat)