使用Github Pages和Cloudflare Pages部署Pelican静态网站

# 创建新环境pelican
conda create -n pelican python=3.10

# 激活新环境pelican
conda activate pelican

mkdir ~/projects/gmlg.com

cd ~/projects/gmlg.com

python -m pip install "pelican[markdown]"

python -m pip install --upgrade pelican

python -m pip install typogrify

pelican-quickstart

Welcome to pelican-quickstart v4.8.0.

This script will help you create a new Pelican-based website.

Please answer the following questions so this script can generate the files
needed by Pelican.


> Where do you want to create your new web site? [.] .
> What will be the title of this web site? 国民老公
> Who will be the author of this web site? Xavier Zhang
> What will be the default language of this web site? [en] en
> Do you want to specify a URL prefix? e.g., https://example.com   (Y/n) y
> What is your URL prefix? (see above example; no trailing slash) https://gmlg.com
> Do you want to enable article pagination? (Y/n) y
> How many articles per page do you want? [10] 10
> What is your time zone? [Europe/Rome] Asia/Shanghai
> Do you want to generate a tasks.py/Makefile to automate generation and publishing? (Y/n) y
> Do you want to upload your website using FTP? (y/N) n
> Do you want to upload your website using SSH? (y/N) n
> Do you want to upload your website using Dropbox? (y/N) n
> Do you want to upload your website using S3? (y/N) n
> Do you want to upload your website using Rackspace Cloud Files? (y/N) n
> Do you want to upload your website using GitHub Pages? (y/N) y
> Is this your personal page (username.github.io)? (y/N) y
Done. Your new project is available at /Users/xavier/Projects/gmlg.com

pelican-themes -U attila   # attila为解压后的主题文件夹

pelican-themes -l

simple
attila
notmyidea

THEME = 'attila'
AUTHOR = 'Xavier'
SITENAME = '国民老公'
SITEURL = ''

python -m pip install pelican-neighbors pelican-webassets pelican-sitemap beautifulsoup4 pelican-readtime   # 具体请参考主题仓库中的配置文件

# 在主目录安装插件
git clone --recursive https://github.com/getpelican/pelican-plugins

python -m pip install pelican-search \
&& python -m pip install pelican-neighbors \
&& python -m pip install pelican-readtime

mkdir themes \
&& cd themes \
&& git clone https://github.com/aleylara/Papyrus.git

mkdir pelican-plugins \
&& cd pelican-plugins \
&& git clone https://github.com/ingwinlu/pelican-toc.git \
# && git clone https://github.com/jameslittle230/stork.git \
&& python -m pip install beautifulsoup4

# Install using Homebrew
brew install stork-search/stork-tap/stork

# Install using the Rust toolchain and install Stork with Cargo 
cargo install stork-search --locked

brew -v  # 根据输出结果的提示，输入下方命令，您的本机目录有可能不同

git config --global --add safe.directory /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core \
&& git config --global --add safe.directory /usr/local/Homebrew/Library/Taps/homebrew/homebrew-cask

rm -rf /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core \
&& brew tap homebrew/core

rm -rf /usr/local/Homebrew/Library/Taps/homebrew/homebrew-cask \
&& brew tap homebrew/cask

brew link stork

AUTHOR = 'Xavier'
SITENAME = '国民老公'
SITEURL = ''
TIMEZONE = 'Asia/Shanghai'
DEFAULT_LANG = 'zh-CN'

SUBTITLE = 'Xavier'
SUBTEXT = '''
一个仍然有望成为<b>国民老公</b>的人。<br>
科技至上主义者，坚信颠覆性创新的力量。<br>
更多信息，可前往 <a class="underline"
href="https://niaodian.com/">鳥電</a> 获取。
'''
COPYRIGHT = '©2023'
PATH = 'content'
THEME = 'themes/Papyrus'
THEME_STATIC_PATHS = ['static']
PLUGIN_PATHS = ['pelican-plugins']
PLUGINS = ['readtime', 'search', 'neighbors', 'pelican-toc']
STATIC_PATHS = [
    'images',
    'images/favicon.ico',
    'extra/robots.txt',
    ]
EXTRA_PATH_METADATA = {
    'extra/robots.txt': {'path': 'robots.txt'},
    'images/favicon.ico': {'path': 'favicon.ico'},
    }

DISPLAY_PAGES_ON_MENU = True
DIRECT_TEMPLATES = (('index', 'search', 'tags', 'categories', 'archives',))
PAGINATED_TEMPLATES = {'index': None, 'tag': None, 'category': None, 'author': None, 'archives': 24, }

# Site search plugin
SEARCH_MODE = "output"
SEARCH_HTML_SELECTOR = "main"
# Table of Content Plugin
TOC = {
    'TOC_HEADERS': '^h[1-3]',   # What headers should be included in
                                # the generated toc
                                # Expected format is a regular expression
    'TOC_RUN': 'true',    # Default value for toc generation,
                          # if it does not evaluate
                          # to 'true' no toc will be generated
    'TOC_INCLUDE_TITLE': 'false',    # If 'true' include title in toc
}

# Feed generation is usually not desired when developing
FEED_ALL_ATOM = 'feeds/all.atom.xml'
CATEGORY_FEED_ATOM = None
TRANSLATION_FEED_ATOM = None
AUTHOR_FEED_ATOM = None
AUTHOR_FEED_RSS = None
RSS_FEED_SUMMARY_ONLY = True

# Social widgets 改成您自己的社交账号
SOCIAL = (
    ('github', 'https://github.com/niaodian'),
    ('twitter', 'https://twitter.com/niaodian'),
    ('instagram', 'https://instagram.com/niaodian'),
    ('telegram', 'https://t.me/niaodian'),
)

# Article share widgets
SHARE = (
    ("twitter", "https://twitter.com/intent/tweet/?text=Features&amp;url="),
    ("linkedin", "https://www.linkedin.com/sharing/share-offsite/?url="),
    ("reddit", "https://reddit.com/submit?url="),
    ("facebook", "https://facebook.com/sharer/sharer.php?u="),
    ("whatsapp", "https://api.whatsapp.com/send?text=Features - "),
    ("telegram", "https://telegram.me/share/url?text=Features&amp;url="),
)

DEFAULT_PAGINATION = 8

# Uncomment following line if you want document-relative URLs when developing
# RELATIVE_URLS = True

# DISQUS_SITENAME = ''
# GOOGLE_ANALYTICS = ''

Title: Installation
Date: 2023-07-13
Tags: CSS, Markdown, Python, AI
Category: Software
Summary: Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nullam dignissim convallis est. Quisque aliquam. Donec faucibus. Nunc iaculis suscipit dui. Nam sit amet sem. Aliquam libero nisi, imperdiet at, tincidunt nec, gravida vehicula, nisl.

pelican content \
&& pelican --autoreload --listen --ignore-cache

$ (pelican) ➜ myProject tree
├── myBlog
│   ├── content
│   │   ├── images
│   │   │   └── camera.png
│   │   ├── pages
│   │   │   ├── about.md
│   │   │   └── events.md
│   │   ├── Hardware
│   │   │   ├── article-one.md
│   │   │   └── article-two.md
│   │   └── Software
│   │       ├── article-three.md
│   │       └── article-four.md
│   ├── Makefile
│   ├── output
│   │
│   ├── pelicanconf.py
│   ├── pelican-plugins
│   │   └── pelican-toc
│   │
│   ├── publishconf.py
│   ├── tasks.py
│   └── themes
│       └── Papyrus
└── venv

<img src="{static}/images/screenshot.png" alt="screenshot" class="image-left image-medium" />
<img src="{static}/images/screenshot.png" alt="screenshot" class="image-right image-thumbnail" />

Alternatively you could use inline styling.
<img src="{static}/images/screenshot.png" alt="screenshot" style="width:200px;" />

<div class="aspect-w-16 aspect-h-9">
    <iframe width="736" height="414" src="https://www.youtube.com/embed/TmWIrBPE6Bc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen>
    </iframe>
</div>

# Initial installation of packages
$ npm install

# JIT compiled main.css
$ npm run dev

├── content
│    ├── extra
│    │    └── robots.txt
│    ├── images
│    │   ├── favicon.ico
│    │   └── camera.png

ssh-keygen -t ed25519 -C "[email protected]"

ssh-keygen -t rsa -b 4096 -C "[email protected]"

$ eval "$(ssh-agent -s)"
> Agent pid 59566

$ open ~/.ssh/config
> The file /Users/YOU/.ssh/config does not exist.

touch ~/.ssh/config

Host github.com
    AddKeysToAgent yes
    IgnoreUnknown UseKeychain
    # 如果你选择不向密钥添加密码，应该省略 UseKeychain 行。
    # 如果看到 Bad configuration option: usekeychain 错误，请在配置的 Host *.github.com 部分添加额外的一行。
    #UseKeychain yes
    IdentityFile ~/.ssh/id_ed25519

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

pbcopy < ~/.ssh/id_ed25519.pub  # 复制 id_ed25519.pub 文件至剪贴板，如果不起作用，可以改用 cat ~/.ssh/id_ed25519.pub

ssh -T [email protected]

git config --global user.name "[username]"
git config --global user.email "[email address]"
# [可选] 启用带帮助的彩色命令行输出
git config --global color.ui auto
# 对于 Windows 用户，建议额外执行下面两条配置
git config --global core.autocrlf true
git config --global core.safecrlf warn

# 检查现在的配置
git config --list
# 获得 config 命令手册
git help config

git rm --cached pelican-plugins/pelican-toc -f
git rm --cached themes/Papyrus -f

git submodule add https://github.com/ingwinlu/pelican-toc.git pelican-plugins/pelican-toc

git submodule add https://github.com/aleylara/Papyrus.git themes/Papyrus

pip freeze > requirements.txt

# 初始化 Git 仓库
git init

git add .
git commit -m "initial commit"

git branch -M main

# 可以部署至公有或私有仓库，建议始终部署至私有仓库，以避免一旦发生信息泄露而出现无法控制的局面
git remote add origin [email protected]:username/username.github.io.git
git push -u origin main

git push -u origin master

# 结果：
# error: src refspec master does not match any
# error: failed to push some refs to 'github.com:niaodian/xavier.git'

git branch -v

# 结果：
# * main b1...28 the first time commit

git show-ref

# 结果：
# b14a328...5a2a747 refs/heads/main

git push -u origin main

# 结果：
# To github.com:username/username.github.io.git
#  ! [rejected]        main -> main (fetch first)
# error: failed to push some refs to 'github.com:username/username.github.io.git'
# hint: Updates were rejected because the remote contains work that you do
# hint: not have locally. This is usually caused by another repository pushing
# hint: to the same ref. You may want to first integrate the remote changes
# hint: (e.g., 'git pull ...') before pushing again.
# hint: See the 'Note about fast-forwards' in 'git push --help' for details.

# --rebase 参数表示：内容拉取之后采用rebase方式合并
git pull --rebase

# 结果：
remote: Enumerating objects: 3, done.
remote: Counting objects: 100% (3/3), done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), 12.40 KiB | 3.10 MiB/s, done.
From github.com:username/username.github.io
 * [new branch]      main       -> origin/main
There is no tracking information for the current branch.
Please specify which branch you want to rebase against.
See git-pull(1) for details.

    git pull <remote> <branch>

If you wish to set tracking information for this branch you can do so with:

    git branch --set-upstream-to=origin/<branch> main

git push -u origin main

# 如果仍旧报错的话，可以添加 -f 参数进行强制提交。由于强制提交可能会毁坏其他的commit记录，在团队协作项目中应谨慎使用。考虑本例为首次提交，使用 -f 参数可以快速解决问题。
# git push -u origin main -f

# 结果：
Enumerating objects: 43, done.
Counting objects: 100% (43/43), done.
Delta compression using up to 8 threads
Compressing objects: 100% (34/34), done.
Writing objects: 100% (43/43), 27.68 KiB | 4.61 MiB/s, done.
Total 43 (delta 12), reused 0 (delta 0), pack-reused 0
remote: Resolving deltas: 100% (12/12), done.
To github.com:username/username.github.io.git
 + dacc0dc...05d46b0 main -> main (forced update)
branch 'main' set up to track 'origin/main'.