nb

nb是一条命令行，本地网络记录，书签，存档和知识库应用程序：

• 纯文本数据存储，
• 加密，
• 过滤，固定，#taging和搜索，
• git支持的版本控制和同步，
• 潘多克支持的转换，
• [[Wiki风格的链接]]，
• 终端和GUI网络浏览，
• 内联图像，
• 带任务的戒酒，
• 全球和本地笔记本，
• 带有文件夹的组织
• 可自定义的颜色主题，
• 通过插件的可扩展性，

以及更多，在一个便携式脚本中。

nb以基于文本的格式创建注释，例如Markdown，Org，Latex和Asciidoc，可以使用任何格式的文件，可以将笔记导入和导出许多文档格式，并可以创建由密码保护的私有密码加密注释和书签。使用nb ，您可以使用VIM，Emacs，VS代码，崇高的文本以及您喜欢的任何其他文本编辑器以及终端和GUI Web浏览器编写注释。 nb在任何标准的Linux / UNIX环境中都可以使用，包括MACOS和Windows通过WSL，MSYS和Cygwin。可以安装可选的依赖性以增强功能，但是没有它们， nb效果很好。

nb也是一个有力的书签系统：

• 本地服务，以文本为中心的，无干扰的书签在终端和GUI网络浏览器中浏览，
• 局部对带有正则表达支持的缓存页面内容的全文搜索，
• 方便的过滤和清单，
• Internet存档Wayback Machine快照查找破裂的链接，
• 标记，固定，链接和与其他nb功能完全集成。

页面信息已下载，清理，结构化并保存到针对人类制作的普通标记文档中，因此书签易于查看和编辑，就像其他任何笔记一样。

nb在后台使用git自动记录更改并与远程存储库同步笔记本。 nb还可以使用通用同步实用程序（例如Dropbox）配置为同步笔记本，以便在任何设备上的其他应用程序中都可以编辑注释。

nb设计为便携式，注重未来的且独立的供应商，在高度可容纳的多模式以用户为中心的文本界面中提供了功能丰富且直观的体验。整个程序包含在一个经过良好测试的外壳脚本中，该脚本几乎可以在任何地方安装，复制或卷曲，并且使用受到渐进增强启发的策略，以在功能更强大的环境中进行各种经验改进。 nb无论您有一个笔记本，只有几张笔记还是数十本笔记本，其中包含数千个笔记，书签和其他物品。 nb使得合并其他工具，编写应用程序和工作流程变得容易。 nb可以偶尔使用一点，或者仅用于一部分功能。 nb是灵活的。

• bash
  • nb与ZSH，FISH和其他任何其他壳体作为主要登录外壳的完美配合，系统只需要在其上提供bash即可。
• git
• 具有命令行支持的文本编辑器，例如：
  • vim，
  • emacs，
  • 视觉工作室代码，
  • 崇高的文字，
  • 螺旋，
  • 微，
  • 纳米，
  • 原子，
  • 文字人，
  • MacDown，
  • 其中一些，
  • 其中许多。

nb利用标准命令行工具和在标准Linux / UNIX环境中工作。 nb还检查了一些其他可选工具的环境，并在可用时使用它们来增强体验。

受到推崇的：

• 蝙蝠
• NCAT或SOCAT
• 潘多克
• RG
• 提格
• W3M

还支持各种增强功能：

Ack, afplay, asciidoctor, The Silver Searcher (ag), catimg, Chafa, Chromium / Chrome, eza, ffplay, ImageMagick, glow, GnuPG, highlight, imgcat, joshuto, kitty's icat kitten, lowdown, lsd, Links, Lynx, mdcat, mdless, mdv, Midnight Commander (mc), mpg123, MPlayer, ncat, netcat, note-link-janitor (via plugin), pdftotext, Pygments, Ranger, readability-cli, rga / ripgrep-all, sc-im, socat, termvisage, termpdf.py, Tidy-Viewer (tv), timg, vifm, viu, VisiData

brew install xwmx/taps/ nb

与自制的nb安装NB还安装了上述建议的依赖项，并为bash，ZSH和FISH安装了填写脚本。

从存储库中安装最新的开发版本：

brew install xwmx/taps/ nb --head

nb也可以在Homebrew-Core中使用。建议将其与Bash公式一起安装：

brew install nb bash

npm install -g nb .sh

NPM安装完成后，运行sudo“ $（ nb ）”完成安装以安装bash和zsh完成脚本（建议）。

在Ubuntu和WSL上，您可以运行sudo“ $（ nb ）” INV安装以安装可选依赖项。

当nb安装在Windows上时，建议使用Socat（MSYS，Cygwin）。

nb也可在其原始软件包名称Notes.sh下找到，该名称带有额外的笔记可执行包装nb 。

要作为管理员安装，请复制并粘贴以下多行命令之一：

 # install using wget
sudo wget https://raw.*git*h*ub.com/xwmx/nb/master/ nb -O /usr/local/bin/ nb &&
  sudo chmod +x /usr/local/bin/ nb &&
  sudo nb completions install

# install using curl
sudo curl -L https://raw.*git*h*ub.com/xwmx/nb/master/ nb -o /usr/local/bin/ nb &&
  sudo chmod +x /usr/local/bin/ nb &&
  sudo nb completions install

在Ubuntu和WSL上，您可以运行sudo nb env安装以安装可选依赖项。

要仅使用用户权限安装，只需将nb脚本添加到您的$路径中即可。例如，如果您已经有一个〜/bin目录，则可以使用以下命令之一：

 # download with wget
wget https://raw.*git*h*ub.com/xwmx/nb/master/ nb -O ~ /bin/ nb && chmod +x ~ /bin/ nb

# download with curl
curl -L https://raw.*git*h*ub.com/xwmx/nb/master/ nb -o ~ /bin/ nb && chmod +x ~ /bin/ nb

仅使用用户权限安装不包括可选的依赖项或完成，但是nb Core功能在没有它们的情况下起作用。如果您具有sudo访问并想要安装完成脚本和依赖项，请运行以下命令：

sudo nb env install

要使用Make安装，请克隆此存储库，导航到克隆的根目录，然后运行：

sudo make install

这还将在所有系统以及Ubuntu和WSL上的建议依赖项上安装完成脚本。

使用BPKG安装：

bpkg install xwmx/ nb 

与Basher一起安装：

basher install xwmx/ nb 

假设您具有适当的系统权限或使用sudo安装，则应在使用上面的方法安装nb时启用Bash，Fish和ZSH选项卡的完成。如果在安装nb后完成完成，请参见“完成安装说明”。

使用NPM或Homebrew等软件包管理器安装nb时，请使用软件包管理器的升级功能将nb更新为最新版本。通过其他方法安装时，可以使用nb Update子命令将nb更新到最新版本。

要开始，只需运行：

 nb

nb首次运行时，将设置您的初始笔记本。

默认情况下，笔记本和注释是全局（〜/ nb ），因此无论当前的工作目录如何，NB始终可供nb使用。 nb还支持本地笔记本。

^{↑· nb添加， nb浏览添加}

使用nb add（快捷方式： nb a， nb +）创建新注释：

 # create a new note in your text editor
nb add

# create a new note with the filename "example.md"
nb add example.md

# create a new note containing "This is a note."
nb add " This is a note. "

# create a new note with piped content
echo " Note content. " | nb add

# create a new password-protected, encrypted note titled "Secret Document"
nb add --title " Secret Document " --encrypt

# create a new note in the notebook named "example"
nb example:add " This is a note. "

# create a new note in the folder named "sample"
nb add sample/

nb添加没有参数或输入将打开环境首选文本编辑器中的新的空白说明。您可以使用$编辑器环境变量或nb集编辑器更改编辑器。

nb文件默认情况下是降级文件。默认文件类型可以更改为您喜欢使用nb SET DEFAULT_EXTENSION的任何内容。

nb Add具有明智的论点解析，并且根据其收到的参数类型的方式行为不同。指定带有扩展名的文件名时，编辑器中打开了带有该文件名的新注释：

 nb add example.md

指定字符串时，立即将其作为内容创建新的注释，而无需打开编辑器：

❯ nb add " This is a note. "
Added: [1] 20200101000000.md

nb添加可用于直接通过命令行快速记下注释。引用内容是可选的，但建议使用。

当未指定文件名时， nb添加使用当前的DateTime作为文件名。

nb Add还可以接收管道内容，其行为与nb Add 相同：

 # create a new note containing "Note content."
❯ echo " Note content. " | nb add
Added: [6] 20200101000100.md

# create a new note containing the clipboard contents on macOS
❯ pbpaste | nb add
Added: [7] 20200101000200.md

# create a new note containing the clipboard contents using xclip
❯ xclip -o | nb add
Added: [8] 20200101000300.md

内容可以使用-Co​​ntent 选项传递，该选项也可以创建一个新的注释，而无需打开编辑器：

 nb add --content " Note content. "

当内容被管道，用-content 指定或以字符串参数传递时，请使用-edit标志在更改进行更改之前打开编辑器中的文件。

标题，文件名和内容也可以用长和简短的选项指定：

❯ nb add --filename " example.md " -t " Example Title " -c " Example content. "
Added: [9] example.md " Example Title "

-t