git是Linus的分布式版本控制软件，据说用了一周写出来，太强了。

##目标

版本控制的目标是，记录每次更改，或者说记录每个版本。除此之外还有额外要求：

• 低成本创建分支
• 保证版本内容的可信性，不被篡改
• 分布式

##思路

我第一个想到的实现方式是，增量存储，记录变更的内容。换句话说，存储的是一堆diff文件。这样的好处是，理论上存储空间会小。但是每一个版本的内容都会是从某一个版本为基础根据diff计算而来。

然而，信息的存储方式其实只是技术细节，关键的问题在于，如何把部分信息提取出来，组成一个版本的文件。 按照我的理解用比喻的方式描述。

假设现在写一本书，但是不是线性写作，而是多个章节同时开始，内容写在一个活页本上。
第一天分别写了一二三节的开头，写在三页纸上，这三页纸有各自的名字，暂且称为a, b, c。再用一张小纸条，记录内容是a, b, c是第一个版本的内容，这个小纸条也有个名字，暂称为A。把它们放进活页本里。
第二天重写了第二节，写在新的一张纸上，这张纸名字是d。同样的，有另一张小纸条，记录内容是a, d, c是第二个版本的内容，这个小纸条的名字记为B。再把它们放进活页本里。
这样，我们就有A, B两个版本了。

##目标的实现

沿用上面的比喻，接下来是一些额外的结构，来使用上述思路实现目标。

首先是分支。其实分支就只是又一个小纸条，贴在A, B这样的小纸条上。比如我是书的主要作者，我在B上贴一个main。我的合作者在A的基础上重写了第三节，写在e这张纸上，并且有个C记录a, b, e，在C上就可以有一个dev的小纸条，这就是dev分支。
保证版本内容的可信性，有2个细节。第一，名字a, b, c和A, B, C其实是sha1，这样可以确保内容和名称匹配。第二，B, C上除了内容，其实还包括它的上一个版本，也就是说B还记录了A的名字，这就保证了历史的可信性。
除此之外，git还使用了内容寻址的存储方式。这张纸a的文件名就是a，而a是内容的sha1，所以不同内容的纸不会在这里，很容易检验信息的真实性。
至于分布式，由于分支只是一个小标签，这就自动满足了。

##ref

##tex 和 latex

###1. TeX：底层排版引擎

• 作者：Donald Knuth（高德纳）开发，1978 年发布。
• 定位：
  • 是一个底层的排版编程语言，提供精确的排版控制（如盒模型、断行算法、数学公式布局等）。
  • 语法类似编程（需手动处理格式细节），适合专业人士或极客。
• 特点：
  • 直接操作命令（如 \hbox, \vskip）。
  • 默认生成 .dvi 文件（需转换为 PDF/PS）。
  • 无预定义的高层结构（如章节、目录需手动实现）。

示例（纯 TeX 代码）：

\font\myfont=cmr12 at 14pt
\myfont Hello, \TeX!
\byecopy

###2. LaTeX：基于 TeX 的高级封装

• 作者：Leslie Lamport（莱斯利·兰波特）开发，1984 年发布。
• 定位：
  • 是 TeX 的宏包集合（一组预定义的命令和模板），提供文档逻辑结构（如章节、参考文献、交叉引用）。
  • 隐藏了 TeX 的底层复杂性，用户只需关注内容。
• 特点：
  • 提供标准文档类（如 article, book）。
  • 内置自动化功能（目录、编号、参考文献管理）。
  • 依赖宏包扩展功能（如 graphicx 插入图片、amsmath 增强数学公式）。

示例（LaTeX 代码）：

\documentclass{article}
\begin{document}
\section{Introduction}
Hello, \LaTeX!
\end{document}copy

###核心区别

###类比解释

• TeX 类似汇编语言：
  • 直接控制硬件（排版细节），但编写复杂。
• LaTeX 类似高级语言（如 Python）：
  • 通过抽象（如 \section）隐藏细节，提升效率。

###技术关系

• LaTeX 本质是一组 TeX 宏（.sty 文件），最终仍由 TeX 引擎（如 pdftex, xetex, luatex）执行。
• 编译流程示例：
  sh

  latex document.tex   # 调用 pdftex 引擎处理 LaTeX 宏
  xelatex document.tex # 调用 xetex 引擎处理 LaTeX 宏copy

###总结

• TeX 是引擎，LaTeX 是模板。
• LaTeX 让用户摆脱 TeX 的底层复杂性，专注于内容逻辑。
• 现代用户通常直接使用 pdflatex/xelatex/lualatex，无需接触原始 TeX 命令。

如果需要进一步解释某个具体细节（如宏包机制或引擎差异），可以继续讨论！

##引擎和使用

###1. 排版引擎（Engines）

引擎是实际执行排版工作的底层程序，负责解析代码、计算布局并生成输出文件（如 PDF/DVI）。
属于引擎的有：

• tex：Knuth 原始 TeX 引擎（生成 .dvi）。
• pdftex：扩展的 TeX 引擎，直接生成 PDF（pdflatex 的基础）。
• xetex（XeTeX）：支持 Unicode 和系统字体的引擎（xelatex 的基础）。
• luatex（LuaTeX）：内嵌 Lua 脚本的引擎（lualatex 的基础）。

###2. 模板/格式（Formats）

格式是基于引擎的预定义命令集合（宏包），提供高层抽象，简化用户操作。
属于格式的有：

• latex：LaTeX 格式（运行在 pdftex/xetex/luatex 等引擎上）。
  • 不是独立引擎，而是通过 latex 命令调用引擎（如 pdftex + LaTeX 宏 → pdflatex）。
• plain tex：Knuth 提供的极简格式（比原始 TeX 稍友好，但远不如 LaTeX）。
• contex：另一种高级格式（基于 LuaTeX，适合复杂排版）。

###3. 前端命令（Frontends）

用户直接调用的命令，本质是 “引擎 + 格式” 的组合：

###关键区分

• 引擎：tex, pdftex, xetex, luatex（核心执行者）。
• 格式：latex, plain tex, contex（定义高级命令的规则）。
• 前端命令：latex, pdflatex, xelatex, lualatex（组合引擎和格式的快捷方式）。

###常见误解澄清

1. latex 不是引擎：
   • 它是 LaTeX 格式通过 pdftex 引擎运行的接口（命令）。
2. pdflatex vs pdftex：
   • pdftex 是引擎，pdflatex = pdftex + LaTeX 格式。

##引擎（Engines）

###基础引擎

###引擎特性对比

##格式（Formats）

###主要格式

##前端命令（Frontend Commands）

###常用命令组合

##文件格式

###输入文件类型

###输出文件类型

##工具链组件

###核心工具

###编译工具链

graph TD
    A[.tex源文件] --> B{选择引擎}
    B --> C[pdflatex]
    B --> D[xelatex]
    B --> E[lualatex]

    C --> F[生成PDF]
    D --> F
    E --> F

    subgraph "可选处理"
        G[.bib文件] --> H[bibtex]
        I[.idx文件] --> J[makeindex]
        H --> K[.bbl文件]
        J --> L[.ind文件]
    end

    K --> C
    L --> C

##选择指南

###引擎选择建议

1. 中文/多语言文档：xelatex 或 lualatex
2. 传统英文文档：pdflatex
3. 需要动态功能：lualatex（Lua脚本）
4. 底层开发：tex 或 luatex

##列举

###1. tex（原始 TeX 引擎）

• 作用：Knuth 开发的原始 TeX 排版引擎，处理 .tex 文件并生成 .dvi（DeVice Independent）文件。
• 特点：
  • 仅支持传统的 TeX 命令，不支持现代字体（如 OpenType）。
  • 主要用于历史兼容性或极简排版。
• 使用示例：
  sh

  tex mydocument.tex  # 生成 mydocument.dvicopy

###2. latex（LaTeX 格式 + pdfTeX 引擎）

• 作用：使用 pdftex 引擎处理 LaTeX 文档（.tex），默认生成 PDF（也可生成 DVI）。
• 特点：
  • 基于 pdftex，支持 PDF 输出、微调排版和基本字体扩展。
  • 但不支持 Unicode 和 OpenType 字体（需额外宏包如 fontspec）。
• 使用示例：
  sh

  latex mydocument.tex  # 生成 mydocument.dvi
  pdflatex mydocument.tex  # 生成 mydocument.pdfcopy

###3. xetex（XeTeX 引擎，支持 Unicode 和系统字体）

• 作用：TeX 引擎，原生支持 Unicode 和系统字体（如 .ttf/.otf）。
• 特点：
  • 直接调用系统字体，无需额外配置。
  • 适用于多语言排版（如中文、阿拉伯语）。
  • 输出格式为 .xdv（扩展 DVI），通常转换为 PDF。
• 使用示例：
  sh

  xetex mydocument.tex  # 生成 mydocument.xdv（通常自动转 PDF）copy

###4. xelatex（LaTeX + XeTeX 引擎）

• 作用：latex 的增强版，使用 xetex 引擎处理 LaTeX 文档，支持现代字体。
• 特点：
  • 支持 fontspec 宏包，可轻松使用系统字体。
  • 适合中文排版（如配合 ctex 宏包）。
• 使用示例：
  sh

  xelatex mydocument.tex  # 直接生成 PDFcopy

###5. luatex（LuaTeX 引擎，支持 Lua 脚本）

• 作用：扩展的 TeX 引擎，内置 Lua 解释器，允许动态脚本控制排版。
• 特点：
  • 支持 Unicode 和 OpenType 字体（类似 XeTeX）。
  • 可通过 \directlua{} 嵌入 Lua 代码，实现高级自动化。
  • 默认生成 PDF。
• 使用示例：
  sh

  luatex mydocument.tex  # 生成 PDFcopy

###6. lualatex（LaTeX + LuaTeX 引擎）

• 作用：latex 的现代替代品，使用 luatex 引擎，结合 LaTeX 和 Lua 扩展。
• 特点：
  • 支持 fontspec 和 Lua 脚本，灵活性极高。
  • 适合复杂排版（如自动生成内容、动态调整格式）。
• 使用示例：
  sh

  lualatex mydocument.tex  # 生成 PDFcopy

###总结对比

##caldav

caldav是一个基于webdav的日历协议，可以用来同步日历数据。它是一个开放的标准，允许不同的日历应用程序和服务之间进行互操作。

包括calendar、todo、event等。

##manage

###todoman

###khal

###apple

原生日历和提醒事项应用程序可以通过CalDAV协议与服务器进行同步。

##host a caldav

###radicale

####Install and configurations

ref: :

Install radicale: 建议用包管理器安装，可以帮助解决依赖，以及创建radicale用户、创建文件夹之类的杂事。比如

sudo dnf install radicalecopy

configurations:

# /etc/radicale/config

[server]
hosts = [::]:5242, 0.0.0.0:5242 # ipv6, ipv4的host，从任何ip地址都可以访问
# hosts = localhost:5242 # 只允许本地地址访问
[auth]
type = htpasswd
htpasswd_encryption = autodetect
htpasswd_filename = /etc/radicale/users
[storage]
filesystem_folder = /var/lib/radicale/collectionscopy

set a user and passwd:

htpasswd -5 -c /path/to/users user1copy

Start as a systemd service:

# /etc/systemd/system/radicale.service
[Unit]
Description=A simple CalDAV (calendar) and CardDAV (contact) server
After=network.target
Requires=network.target

[Service]
ExecStart=/usr/bin/radicale --config /etc/radicale/confif
Restart=on-failure
User=radicale
# Deny other users access to the calendar data
UMask=0027
# Optional security settings
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
PrivateDevices=true
ProtectKernelTunables=true
ProtectKernelModules=true
ProtectControlGroups=true
NoNewPrivileges=true
ReadWritePaths=/var/lib/radicale/ /var/cache/radicale/

[Install]
WantedBy=multi-user.targetcopy

这样在http://localhost:5242/就可以访问web页面，可以创建collection等。

####host

用cloudflare的zero trust - network - tunnel来将radicale服务暴露到公网。记得选https。

###baikal

##connect a caldav

###from linux

vdirsync

###from apple to caldav server

###To apple caldav

ref:

云上贵州服务器

https://<server-id>-caldav.icloud.com.cn/<user-id>/calendars/<calendar-id>/copy

在网页版icloud的日历界面打开开发者工具，然后找Network里的Get请求，过滤XHR，然后找类似 https://<server-id>-calendarws.icloud.com.cn/ca/eventdetail/<calendar-id>/<event-id>?clientBuildNumber=<some-random-text>&clientId=<some-random-text>&clientMasteringNumber=<some-random-text>&clientVersion=<some-random-text>&dsid=<user-id>&lang=<some-random-text>&requestID=<some-random-text>&usertz=<some-random-text>的内容。

用 将icloud的日历同步到本地，以.ics格式存储。

[storage cal]
type = "caldav"
url = "https://caldav.icloud.com/"
username = "..."
password = "..."

[storage card]
type = "carddav"
url = "https://contacts.icloud.com/"
username = "..."
password = "..."copy

这里username就是用户名，而password是双重认证后再生成的app密码。服务器的话中国应该要url = "https://caldav.icloud.com.cn/"

但是有两个问题：

• 不支持VTODO格式，apple的提醒事项似乎不是这个协议。
• icloud如果有多个日历的话，标识id很长，难以记忆或使用，例如87BBBA05-934B-4D5A-BB27-771A9CD413A2。或者其中一个会被记为home，但是不知道什么规则。例如同步到.local/share/calendars后
  TEXT

  ~/.local/share/calendars
  ├── 87BBBA05-934B-4D5A-BB27-771A9CD413A2
  └── homecopy

This standard consists of a set of requirements and guidelines for file and directory placement under UNIX-like operating systems. The guidelines are intended to support interoperability of applications, system administration tools, development tools, and scripts as well as greater uniformity of documentation for these systems.

##General setting

###under /

/bin : Essential user command binaries (for use by all users). /sbin : System binaries. stored in /sbin, /usr/sbin, and /usr/local/sbin. /lib : Essential shared libraries and kernel modules lib32 and lib64: Alternate format essential shared libraries (optional) /etc : Host-specific system configuration. A “configuration file” is a local file used to control the operation of a program; it must be static and cannot be an executable binary.

/media : Mount point for removable media /mnt : Mount point for a temporarily mounted filesystem /opt : Add-on application software packages /run : Run-time variable data /srv : Data for services provided by this system /tmp : Temporary files

###/usr

/
└── usr
    ├── bin
    ├── include
    ├── lib
    ├── sbin
    ├── share
    └── srccopy

/usr is the second major section of the filesystem. /usr is shareable, read-only data. That means that /usr should be shareable between various FHS-compliant hosts and must not be written to. Any information that is host-specific or varies with time is stored elsewhere.
Large software packages must not use a direct subdirectory under the /usr hierarchy. (maybe /opt)

• /usr/share : Architecture-independent data. The /usr/share hierarchy is for all read-only architecture independent data files.
  This hierarchy is intended to be shareable among all architecture platforms of a given OS; thus, for example, a site with i386, Alpha, and PPC platforms might maintain a single /usr/share directory that is centrally-mounted. Note, however, that /usr/share is generally not intended to be shared by different OSes or by different releases of the same OS.
  Any program or package which contains or requires data that doesn’t need to be modified should store that data in /usr/share (or /usr/local/share, if installed locally). It is recommended that a subdirectory be used in /usr/share for this purpose. Applications using a single file may use /usr/share/misc.
  Game data stored in /usr/share/games must be purely static data. Any modifiable files, such as score files, game play logs, and so forth, should be placed in /var/games.
• /usr/lib: Includes object files and libraries. On some systems, it may also include internal binaries that are not intended to be executed directly by users or shell scripts.
  Applications may use a single subdirectory under /usr/lib. If an application uses a subdirectory, all architecture-dependent data exclusively used by the application must be placed within that subdirectory.
• /usr/local : Local hierarchy (empty after main installation) The /usr/local hierarchy is for use by the system administrator when installing software locally. It needs to be safe from being overwritten when the system software is updated. It may be used for programs and data that are shareable amongst a group of hosts, but not found in /usr.

And others:

• games: Games and educational binaries (optional)
• include: Header files included by C programs. This is where all of the system’s general-use include files for the C programming language should be placed.
• libexec: Binaries run by other programs (optional)
• src: Source code (optional)

###Summary

• May under ‘/’,/usr,/var

├── bin # binary
├── lib # library
├── include # C header
├── games   # games
├── opt # opt
├── share   # data that share with other
└── src     # sourcescopy

• only under /

/
├── boot
├── etc # configraturation
├── dev
├── media
├── mnt
├── proc
├── run
├── srv
├── sys
└── tmpcopy

##On archlinux,

/
├── bin ⇒ usr/bin
├── boot
├── dev
├── etc
├── home
├── lib ⇒ usr/lib
├── lib64 ⇒ usr/lib
├── mnt
├── opt
├── proc
├── root
├── run
├── sbin ⇒ usr/bin
├── srv
├── sys
├── tmp
├── usr
└── varcopy

lib32 and lib64 for 32-bit and 64-bit. sbin binaries for super user. (On debian, only root can reboot.)

/
└── opt
    ├── waterfox
    ├── wechat-universal
    └── wemeetcopy

/
└── usr
    └── share
        ├── alsa
        ├── applications
        ├── awk
        ├── blueman
        ├── mime
        ├── nvim
        ├── wayland
        ├── wayland-sessions
        ├── X11
        └── zshcopy

/
└── usr
    └── local
        ├── bin
        ├── etc
        ├── games
        ├── include
        ├── lib
        ├── man
        ├── sbin
        ├── share
        └── srccopy

/
└── var
    ├── cache
    ├── db
    ├── empty
    ├── games
    ├── lib
    ├── local
    ├── lock ⇒ ../run/lock
    ├── log
    ├── mail ⇒ spool/mail
    ├── opt
    ├── run ⇒ ../run
    ├── spool
    └── tmpcopy

###special directories

/
├── boot
│   ├── efi
│   ├── grub
│   ├── initramfs-linux.img
│   └── vmlinuz-linux
├── dev
│   ├── disk
│   ├── null
│   ├── random
│   └── zero
├── mnt
├── proc
│   ├── 1
│   ├── uptime
│   └── zoneinfo
├── run
│   ├── dhcpcd
│   ├── initramfs
│   ├── media # This is different
│   ├── libvirt
│   ├── systemd
│   └── xtables.lock
├── srv
│   ├── ftp
│   └── http
├── sys
│   ├── kernel
│   └── power
└── tmpcopy

##homes

/
├── home
│   └── user
│       ├── Desktop
│       ├── Documents
│       ├── Downloads
│       ├── Music
│       ├── Pictures
│       ├── Public
│       ├── Templates
│       └── Videos
└── root
    ├── Desktop
    ├── Documents
    ├── Downloads
    ├── Music
    ├── Pictures
    ├── Public
    ├── Templates
    └── Videoscopy