Tp-Note：增强标记的粒度笔记

保存和编辑您的剪贴板内容为笔记文件

Tp-Note 是一个笔记工具和模板系统 - 免费提供Windows、MacOS和Linux版本 - 它始终将笔记的元数据与其文件名同步。 Tp-Note 的主要设计目标是将一些输入文本（通常由系统剪贴板提供）转换为具有描述性YAML标题和有意义的文件名的Markdown笔记文件。 Tp-Note 收集有关其环境和剪贴板的各种信息并将它们存储在变量中。通过在预定义和可自定义的 Tera 模板中填充这些变量来创建新笔记。 TP-Note 的默认模板是用Markdown编写的，如果需要，可以轻松地适应任何其他标记语言。创建新笔记后，TP-Note 启动系统文本编辑器并将默认网络浏览器连接到 Tp- Note 的内部Markdown/RestructuredText渲染器和网络服务器。查看器检测笔记文件更改并根据需要更新渲染。

在 2023-12-19 周二 12:58 +1100，Dev Rain 写道

在一段时间前发现了Tp-Note，它已成为我日常工作流程的一部分，确实是我的日常笔记生活的一部分。我想表达我的感谢；所以谢谢。dev.rain

更多内容请参阅 Tp-Note用户手册，下载Tp-Note 或访问项目页面：Tp-Note - 极简笔记。

文档

用户文档

• 入门视频

  Tp-Note - 最常用用例 - YouTube

• 项目页面

  Tp-Note的项目页面，您现在正在阅读的页面，列出了您可以下载 Tp-Note 的位置，并概述了 Tp-Note 的资源和文档。

• 用户手册

  用户手册展示了如何最佳使用Tp-Note以及如何将其与您的文件管理器集成。

  Tp-Note用户手册 - html

  Tp-Note用户手册 - pdf

• Unix man-page

  Unix man-page是Tp-Note的技术参考。在这里，您可以学习如何自定义Tp-Note的模板以及如何更改其默认设置。

  Tp-Note手册页 - html

  Tp-Note手册页 - pdf

• 关于Tp-Note的博客文章

开发者文档

• API文档

  Tp-Note的程序代码文档主要针对软件开发者。代码分为库tpnote-lib和命令行应用tpnote。高级用户可以查阅Tp-Note的config模块文档，该文档解释了默认模板和设置。其中许多都可以通过Tp-Note的配置文件进行自定义。

  API文档中的常量

源代码

仓库

• Tp-Note在Gitlab上

• Tp-Note在Github（镜像）上

分发

下载安装包和二进制文件

Tp-Note Microsoft Windows安装包

• Windows安装包

  tpnote-latest-x86_64.msi

  由于这个Windows安装程序的早期版本尚未签名，Windows将显示错误消息“Windows保护您的PC”。作为一个解决方案，当您点击“更多信息”链接时，将出现一个“运行”按钮，允许您继续安装过程。一般来说，无论程序来自何处，我都建议使用VirusTotal检查每个可安装文件。

Tp-Note Debian/Ubuntu安装包

• 为Debian编译的包

  x86_64-unknown-linux-gnu/debian/tpnote_latest_amd64.deb

Windows、MacOS和Linux的各个二进制文件

• Ubuntu-Linux 18.04、Windows、MacOS的二进制文件

  1. 打开：发布 - getreu/tp-note

  2. 打开最新发布版。

  3. 打开assets。

  4. 下载适用于您的操作系统的打包可执行文件。

  5. 安装：见下文。

• Windows的可执行文件

  • x86_64-pc-windows-gnu/release/tpnote.exe

• Linux二进制文件（使用Debian编译）

  • x86_64-unknown-linux-gnu/release/tpnote

  • 以下“musl”版本也适用于无头系统。

    x86_64-unknown-linux-musl/release/tpnote

• Raspberry Pi的二进制文件（32位）

  • armv7-unknown-linux-gnueabihf/release/tpnote

• Raspberry Pi的二进制文件（64位）

  • aarch64-unknown-linux-gnu/release/tpnote

Tp-Note在官方包仓库中

Tp-Note在NetBSD上

• 在NetBSD和其他“pkgsrc”支持的平台上可提供官方包。

  要在NetBSD上安装Tp-Note，只需使用本机包管理器

  pkgin install tpnote
  

Tp-Note在NixOS上

• 在NixOS上有官方包

   environment.systemPackages = [ pkgs.tpnote ]; 
  

使用Nix包管理器获取Tp-Note

• 首先安装适用于Linux、MacOS和Windows（WSL2）的Nix包管理器。对于Linux，还有预构建的Deb/Pacman/Rpm Nix安装程序。

  一旦您的系统上安装了Nix包管理器，您可以用以下方式尝试Tp-Note

  nix-shell -p tpnote
  

  或遵循以下安装说明：NixOS包 - tpnote

其他资源

• 将Unix man-page复制到/usr/local/share/man/man1

  • tpnote.1.gz

• 将Tp-Note的图标复制到/usr/local/share/icons/

  • tpnote.svg

安装

根据您操作系统的安装包可用性，安装过程程度自动化。对于Windows用户，提供完全自动化的安装包tpnote-latest-x86_64.msi。更多详情，请参考上面的分发部分和《Tp-Note》手册中的安装部分。

升级

在升级《Tp-Note》时，新功能可能会导致《Tp-Notes》的配置文件结构发生变化

*** ERROR:
Can not load or parse the (merged) configuration file(s):
---
invalid length 3, expected fewer elements in array in `viewer.served_mime_types`


Note: this error may occur after upgrading Tp-Note due to some incompatible
configuration file changes.

Tp-Note renames and thus disables the last sourced configuration file.

Additional technical details:
*    Command line parameters:
tpnote -b 
*    Sourced configuration files:
/home/joe/.config/tpnote/tpnote.toml

配置文件备份存储在与最后源配置文件相同的目录中，例如 /home/joe/.config/tpnote/。如果《Tp-Note》引用了多个配置文件，请考虑这些文件中可能存在的语法错误（参见《Tp-Note》手册页面的自定义部分）。

构建

如果上述预编译的二进制文件不符合您的要求，您可以自己编译《Tp-Note》。

1. 安装Rust，例如。

   curl https://sh.rustup.rs -sSf | sh
   
   sudo apt install build-essential    
   

   现代Linux桌面通常已预装所需的共享库。以下列出《Tp-Note》（Debian）二进制文件所依赖的库

   ldd target/x86_64-unknown-linux-gnu/release/tpnote 
        linux-vdso.so.1
        libgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1
        librt.so.1 => /lib/x86_64-linux-gnu/librt.so.1
        libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0
        libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6
        libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2
        libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6
        /lib64/ld-linux-x86-64.so.2
   

2. 下载、编译和安装《Tp-Note》

   在Linux上构建

   cargo install tpnote
   sudo cp ~/.cargo/bin/tpnote /usr/local/bin
   # Copy icon
   sudo cp assets/tpnote.svg /usr/local/share/icons
   

   与之前的Linux版本（<= 1.19.13）不同，现在《Tp-Note》将错误和调试信息作为通知显示。这需要一个遵循XDG规范的基于Linux/BSD的桌面环境，例如KDE、Gnome、XFCE、LXDC、Mate（以及可能还有其他大多数）。

   使用通知也消除了以前的GTK依赖。无论如何，如果您只想在控制台看到错误信息，可以通过省略message-box功能来选择不显示通知和信息框。在这种情况下，所有错误信息都将在启动《Tp-Note》的控制台上输出到stderr

   cargo install --no-default-features \
     --features lang-detection,read-clipboard,renderer,viewer \
     tpnote
   sudo cp ~/.cargo/bin/tpnote /usr/local/bin
   

   推荐的Linux控制台和服务器版本

   《Tp-Note》的全功能版本依赖于如Xlib之类的GUI库，这些库可能不适用于无头系统。可以下载Musl版本x86_64-unknown-linux-musl/release/tpnote，或者在没有默认功能的情况下自己编译《Tp-Note》

   cargo install --no-default-features \
     --features lang-detection,renderer tpnote
   sudo cp ~/.cargo/bin/tpnote /usr/local/bin
   

   如果关注《Tp-Note》的二进制文件大小，可以在上面的cargo调用中省略lang-detection功能。由于其广泛的语言模型，lang-detection功能导致最终二进制文件大小的95%。

   在Windows和macOS上构建

   使用以下方法构建全功能版本

   cargo install tpnote
   

   在为Windows或macOS构建时，排除message-box功能没有意义，因为在Windows和macOS上，它不依赖于通知库。相反，它使用直接的操作系统的API调用来弹出警报框。由于这些调用对二进制文件大小或速度没有影响，始终在编译时包含message-box功能。

   请参阅用户手册以获取更详细的安装说明。

交叉编译

Debian使为外国架构交叉编译变得容易。以下是一些示例

• 目标Musl

  rustup target add x86_64-unknown-linux-musl
  sudo apt install musl-tools
  
  cargo build --target x86_64-unknown-linux-musl --release
  

• 目标树莓派（32位）

  rustup target add armv7-unknown-linux-gnueabihf
  sudo apt install crossbuild-essential-armhf
  
  CARGO_TARGET_ARMV7_UNKNOWN_LINUX_GNUEABIHF_LINKER=/usr/bin/arm-linux-gnueabihf-gcc \
    cargo build --target armv7-unknown-linux-gnueabihf --release
  

• 目标树莓派（arm64，64位）

  rustup target add aarch64-unknown-linux-gnu
  sudo apt install crossbuild-essential-arm64
  
  CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER=/usr/bin/aarch64-linux-gnu-gcc \
   cargo build  --target aarch64-unknown-linux-gnu --release
  

• 目标Windows

  rustup target add x86_64-pc-windows-gnu  
  sudo apt install binutils-mingw-w64 mingw-w64
  cargo build --target x86_64-pc-windows-gnu --release 
  

本项目遵循语义版本控制。

关于

作者

• Jens Getreu

版权

• Apache 2许可证或MIT许可证。