Computer Science¶
使用 pre-commit 为 Git 仓库设置自动任务
pre-commit 可以在提交代码前自动完成代码格式化、commit message 格式校验等任务。在联网环境下,直接填写 GitHub 中的 pre-commit hook 配置即可。此外,本文还介绍了如何在离线环境下配置 pre-commit。
JupyterLite:在浏览器中运行 Python
JupyterLite 是一个轻量级的 Jupyter 笔记本环境,旨在为用户提供快速、便捷的交互式计算体验。与传统的 Jupyter 环境不同,JupyterLite 可以在不需要安装任何软件的情况下直接在浏览器中运行。
有时我们希望快速测试一些简单的代码(例如得到 ChatGPT 给出的代码后),就可以用 JupyterLite 在浏览器中快速运行代码。
本文记录了如何部署 JupyterLite 站点,以及参与开源项目贡献的心得。
计算机教育中缺失的一课:The shell
大学里的计算机课程通常专注于讲授从操作系统到机器学习这些学院派的课程或主题,而对于如何精通工具这一主题则往往会留给学生自行探索。在这个系列课程中,我们讲授命令行、强大的文本编辑器的使用、使用版本控制系统提供的多种特性等等。学生在他们受教育阶段就会和这些工具朝夕相处(在他们的职业生涯中更是这样)。
因此,花时间打磨使用这些工具的能力并能够最终熟练地、流畅地使用它们是非常有必要的。
精通这些工具不仅可以帮助您更快的使用工具完成任务,并且可以帮助您解决在之前看来似乎无比复杂的问题。
常用的 Git 代码
本文记录了常用的 Git 命令,并转载了一些优质博文(见相关链接)作为补充。
三个基本概念
- 工作区 (Workspace) 是计算机中项目的根目录
- 暂存区 (Index) 像个缓存区域,临时保存你的改动
- 版本库 (Repository) 分为本地仓库(Local) 和远程仓库 (Remote)
基于 giscus 为网站添加评论系统
giscus 是一个简单易用的评论系统,它使用 GitHub Discussions 的作为存储和管理评论的后端。网站的访客可以使用 GitHub 账号登录并发表评论,当有新评论时 GitHub 还会用邮件通知网站的主人。
本文记录了基于 giscus 为网站添加评论系统的过程。整个过程还算比较顺利,但中途遇到的关于一键配置多个页面展示评论系统的问题也困扰了我很久。将其记录于此,希望能帮助自己和他人。
Typora 设置默认代码语言
在 Typora 中可以插入代码块,但每次都需要手动添加语言。若经常需要插入同一种语言的代码块,可以借助第三方的快捷键工具 AutoHotkey,自动设置代码块的语言,提高工作效率。
VS Code 加载 Web 视图时出错的解决方案
报错原因
在保存一个大型jupyter notebook
文件时,自己突然关闭了标签页。再打开它时,VS Code 就报错:
加载 Web 视图时出错: Error: Could not register service workers: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state..
并且也不能打开其他任何jupyter notebook
文件,推测是 VS Code 程序出了问题。
解决方案
我自己曾经遇到过两次这个报错,第一次是在个人电脑 Windows 系统上,第二次是在 Linux 服务器上。下面分别介绍针对这两个系统的解决方案。
中文技术文档的写作规范
本文转载了阮一峰的《中文技术文档的写作规范》。
本站之前发布的文章有许多并没有遵循这一规范(例如中英文之间应有空格)。在今后的工作和写作中,我会尽量书写规范的文档,提高文章的易读性。
Linux 命令行—文件操作
在 Linux 中常用的操作文件的命令。
Linux 和 Mac OS 自带的 Bash 中可以使用 Linux 命令。Windows 系统自带的 Command Prompt(命令提示符)并不是最常用的,很多 Linux 命令在命令提示符中无法使用,它们有一些等价的对应关系。
Windows 的 Powershell 可以用一些 Linux 命令。