这是一篇置顶文章🔝
暂时先用文章置顶做公告吧,置顶样式也没做,新开发的主题,还在完善中,先这样用着吧。 新的博客主题 我在之前的《读“张洪Heo”博客设计有感》一文中也谈过自己的审美偏好,由于我个人不是很喜欢花哨的博客前端页面,更不喜欢“千篇一律”的花哨,更加注重记录本质。所以,即使现在已经有很多优秀开发者分享了他们的
旁注笔记系统(二):两种行级评论方案分析
之前在 旁注式笔记系统的思考(一) 中,思考过如何将 " 旁注笔记 " 和源博客文本既能关联起来,又能无侵入的方法。今天偶然在看 Handsome 大佬的博客时,他实现了一个 支持 Markdown 行级别评论 功能,其实这个 " 行级别评论 " 功能和 " 旁注笔记 " 非常相似,所以分析了下他的
旁注式笔记系统(二):基于Obsidian文本块的实现方案
需要思考的问题 先罗列一下自己的疑问: 前端是展示还是编辑系统? 两篇笔记的关联方式,锚点定位机制,是否双向链接? 源文本与旁注,是在同一篇文章内部——类似脚注锚点的方式?还是相互独立,对源文本无侵入的方式? 上述两者必定需要关联,要么是类似脚注锚点的关联,要么是两篇独立文章之间的关联。 脚注锚点式
博客文献旁注功能的实现方法分析
你需要的是在博客中实现 “旁注”或“边栏批注” 的功能,这在数字阅读和学术博客中很常见。下面我将从 实现思路、现有方案、以及具体操作 几个方面为你解答。 🧠 核心思路 你想实现的是: 左侧:文献原文(或摘录) 右侧:你的理解性批注、补充想法 保持视觉上的对应关系,便于对照阅读 这本质上是一种 “并
Obsidian内部引用路径处理:generateMarkdownLink与fileToLinktext API解析
前言 Obsidian 对内部引用路径的处理方式,不是完全的 url 编码,只是对空格这类字符进行编码。为了实现 webLink 和 internalLink 转换的一致性以及 Obsidian 编辑器输入 [[]] 自动转换链接时逻辑的一致性,建议使用 Obsidian 内部的 api 来获取文件
基于扁平数据结构的 Obsidian-Halo 同步插件设计
分类、文档文件夹在本地的数据存储方式 数据存储方式必须采用扁平结构,便于更新读取,也能保持数据整洁性。 [
{
name,
priority,
displayName, // 做文件夹名称
parent, // 构建树形结构用
kind: Category/docs/Project
Obsidian-Halo同步插件设计思考:API机制、数据结构与冲突处理
记录 Obsidian 存在内部 api,例如 FileExplorerView 类型等。 已有排序项目的修改原理,猴子补丁技术 monkey-around 的了解。 更多关于内部 api d的信息,在 Obsidian Discard 论坛搜索 “FileExplorerView” 得到相关讨论:
Halo主题PJAX实践通用方案:问题分析、设计哲学与实现
一、问题分析 先分析下,全页面加载(Full Page Load)和 pjax(PushState + Ajax)请求方式中有哪些 js 引入和方法调用的行为,然后针对差异给出解决方案。 1.1 全页面加载下 js 的引入和方法调用 全页面加载情况下,我们通常会有以下的 js 引入行为: 各个页面公
博客系统新构想:解耦编辑器与渲染器,让主题开发者定制文章模板
博客只作为内容管理的容器,例如存储、查找等,编辑器只作为输入内容的入口,将编辑器模板渲染和最终网页渲染交给主题开发者。由于自定义程度较高,最好是基于富文本编辑器做。 以瞬间为例,当我们在编辑器切换分类模板后,编辑器就会由一个主题开发者自己规定的模板,例如有内容块、图片块、位置信息块,由自己提供 cs
博客文章目录树设计思路:状态管理与Pjax适配
简单记录和理顺一下想到的思路, 设计思路 核心是文章分类目录树,但也可能会有其他项目,例如首页、友链等。 核心问题是,项目选中状态问题和目录树展开状态问题。 项目选中状态:每个项目有一个独特的 id,统一用这个标识做标记样式类,方便 thymeleaf 初始化,也方便 Alpine 响应式切换。 目