办公 · 2024年 10月 21日

zettlr笔记git版本控制

zettlr

zettlr简介

Zettlr号称是21世纪的笔记Markdown编辑器。

Zettlr 是一位名叫 Hendrik Erz 的德国社会学家/政治理论家创建的。Hendrik 创建了 Zettlr,因为他对目前的文字处理器感到不满意。他想要可以让他“专注于写作和阅读”的编辑器。

在发现 Markdown 之后,他在不同的操作系统上尝试了几个 Markdown 编辑器。但它们都没有他想要的东西。[根据 Hendrik 的说法],“但我不得不意识到没有为高效组织大量文本而写的编辑器。大多数编辑都是由编码人员编写的,因此可以满足工程师和数学家的需求。没有为我这样的社会科学、历史或政治学的学生的编辑器。“

首先,Zettlr支持导入bib,json等文件来获取参考文献。支持导入CSL文献来定义参考文献的显示样式。这个功能对于科研工作者来说,可以说是直戳痛点。在写论文时参考文献是十分重要的。有些人使用wrod来写论文,使用Endnote等软件来插入引用。有些人会使用Latex来写论文。我个人比较倾向于使用Latex来写论文。但是在如果使用Latex来记笔记的话,好像有没有什么特别好的笔记管理软件(欢迎指正)。如果使用更轻便的Markdown的话,当然也可以插入参考文献,但是要配合Pandoc来使用,也不能说是非常的方便。但是本文中Zettlr我觉得在参考文献插入方面可以说是非常的自然了。

其次,Zettlr中支持公式的渲染。这个功能很多Markdown编辑器都支持。但是如果不支持的话,对于工科党来说会是相当头疼的问题。

另外,Zettlr的其他特点诸如没有文件夹的概念,使用标签来管理笔记,反向链接,这些都是为ZettelKasten方法服务的。

  • 特点
    • 针对学术研究和写作优化,支持文献管理和引文功能。
    • 纯本地文件(Markdown 格式)。
    • 支持标签、搜索功能。
  • 适合:学术研究和需要严格 Markdown 管理的用户。

  • 同步方式:通过 Git、云盘等工具。

安装与设置

  • 下载

  • 初始设置
    • 打开后,选择工作空间(Workspace)文件夹,Zettlr 会将笔记存储为纯 Markdown 文件。
    • 配置语言、主题(偏好深色/浅色模式)。

创建与管理笔记

  • 创建笔记
    • 点击左上角的“+”号,创建新 Markdown 文件。
    • 默认保存到工作空间文件夹,可按需移动或分类。
  • 命名文件
    • 使用清晰的文件名,如 2024-11-20-Research-Notes.md
  • 组织笔记
    • 使用文件夹或标签(#标签)进行分类。
    • 文件夹层级关系直接反映在侧边栏中。

Markdown 编辑基础

  • 常用语法
    • 标题# 一级标题## 二级标题### 三级标题

    • 加粗**加粗文字**

    • 斜体*斜体文字*

    • 列表

    • 无序列表:- 项目

    • 有序列表:1. 项目

    • 链接[链接文字](https://example.com)

    • 图片![图片描述](图片路径)

  • 实时预览

    • Zettlr 支持在编辑时直接渲染 Markdown,无需额外切换。

搜索与标签

  • 全局搜索
    • Ctrl + Shift + F(Windows/Linux)或 Cmd + Shift + F(macOS),快速查找笔记内容。
  • 使用标签
    • 在内容中添加 #标签,便于分类和快速查找。
    • 在左侧栏的“Tags”视图中可查看所有标签。

引用与文献管理

  • 文献库集成
    • 配置 Zotero 或其他参考文献管理工具:
    1. 在设置中启用 BibTeX 支持。
    2. 导入 .bib 文件,关联文献库。
    • 在笔记中插入参考文献:[@引用标识]
  • 生成参考文献
    • 使用 Pandoc 导出时,自动生成参考文献列表。

导出与格式转换

  • 支持格式
    • 可以将 Markdown 笔记导出为 PDF、HTML、Word 等格式。
  • 快速导出
    • 文件菜单 → 导出 → 选择格式。
  • 高级导出(需要安装 Pandoc 和 LaTeX):
    • 支持更复杂的格式,如学术论文风格 PDF。

快捷键

  • 常用快捷键
    • 新建文件Ctrl + N
    • 全局搜索Ctrl + Shift + F
    • 切换侧边栏Ctrl + B
    • 预览模式Ctrl + Shift + P

提高效率的插件和工具

  • 语法高亮:内置支持,无需额外设置。
  • 自动同步
    • 将工作空间文件夹同步到云端(如 OneDrive、Google Drive、Dropbox)实现多设备同步。
  • 结合 Git
    • 将工作空间作为 Git 仓库管理笔记版本。

学习资源推荐

  • 官方文档
  • 社区教程
    • 在 YouTube 搜索 “Zettlr Markdown Tutorial”,可以找到不少实操演示。
  • Markdown 基础

个人git仓库

在现代软件开发中,Git 已经成为最流行的版本控制系统之一。虽然 GitHubGiteeGitLab 等公共服务提供了方便的托管平台,但有时候由于安全性、隐私或其他定制化需求,我们可能需要搭建一个自己的 Git 服务器。

Git 简介

Git 是一个分布式版本控制系统,由 Linus Torvalds 于2005年开发。它能够快速高效地处理从小型到大型项目的所有版本管理需求。由于其分布式的特性,每个开发者都拥有完整的代码库历史,这意味着即使没有服务器,开发者之间也能进行协作。

为什么要私人 Git 服务器

使用公共 Git 托管服务非常方便,但有些企业或个人开发者可能会考虑搭建自己的 Git 服务器,主要出于以下原因:

  • 数据隐私:保证源代码和版本历史只存储在内部网络中,减少外部泄露的风险。
  • 定制化需求:可以根据自身需求定制服务器配置和工作流程。
  • 成本:对于大规模项目或私有项目,搭建自己的服务器可能比长期付费使用公共服务更划算。

环境需求

  • 操作系统:大多数情况下,建议使用 Linux 发行版(如 Ubuntu、CentOS)。当然,Windows 和 macOS 也可以,但配置可能稍有不同。
  • 硬件要求:普通的项目管理中,一个最低配的 VPS(1-2GB RAM,1-2核CPU)通常足够。如果管理多个大项目或有高并发需求,建议使用更高配的服务器。
  • 网络要求:确保服务器有一个静态IP地址,以便开发者能够稳定地访问。

安装和配置服务器 Git

  • 安装 git
    如果是云服务器,默认是安装好 git的,如果没有安装,
  • WindowsGit for Windows 下载

  • macOS:通过 Homebrew 安装:brew install git

  • Linux:通过包管理器安装,例如在 Ubuntu 上使用:sudo apt-get install git

安装完成后,验证 Git 是否安装成功:git --version

  • 创建 git账户,并更改密码
sudo useradd -d /home/git/ -s /bin/bash git
sudo passwd git

部署 git 仓库

su - git
mkdir zettlrRgit
cd zettlrRgit
git init --bare doc.git

此时,我们的服务器仓库就成功部署完成,是不是非常简单!

使用 git 仓库

  • windows操作系统,建议使用 sourceTree 图形化客户端
    创建本地 Git 仓库
  1. 打开 Zettlr 工作空间文件夹所在的位置。
  2. 右键点击该文件夹,选择 “Git Bash Here”(Windows)或打开终端(macOS/Linux)并切换到该文件夹:cd /path/to/your/zettr-workspace
  3. 在终端中初始化 Git 仓库:git init

    配置 Git 用户信息

如果这是您第一次使用 Git,您需要配置您的用户名和电子邮件地址:

git config --global user.name "Your Name"
git config --global user.email "your-email@example.com"

如果是 soureTree,第一次启动软件会有提示,通过对话框就能配置,输入用户名和邮件

远程配置
对于服务器修改 ssh 默认端口的情况,通过如下方式添加:git remote add origin ssh://git@xx.xx.xx.xx:13579/home/git/zettlrRgit/doc.git
如果没有修改 ssh 端口: git remote add origin git@ip:zettlrRgit/doc.git

推送到远程

git push -u origin master

免密登录
sourceTree 选择命令行模式,进入后
输入 ssh-keygen -t rsa,然后在 user 下的 .ssh中,将公钥传到服务器 git用户的 authorized_keys
sourceTree工具菜单栏的 选项中,ssh客户端选择openSSH,密匙选择对应的私匙即可

  • linux 直接使用命令行

参考文献:
搭建 Git 私人服务器完整指南_私有git服务器-CSDN博客

TOC