¶ 1 格式兼容问题处理
¶ 1.1 属性Properties
wiki.js会要求由如下属性，函数process_properties()会自动删除原有文档的属性，并增加如下属性
---
title: 从obisidian迁移数据到wiki.js
description:
published: true
date: 2024-04-17T01:48:43.750+8:00
tags:
editor: Ring
dateCreated: 2024-04-17T01:48:43.750+8:00
---
¶ 1.2 图片Attachment
图片问题由process_attachments()处理
- obisidian中的图片全部由官方社区插件
Attachment Management管理，附件也是以.md的目录结构管理，非常方便。 - obisidian中图片格式为
![[pictureName|200x200]]，将其统一更改为wiki.js支持的方式 - 脚本会处理所有
![[*]]格式的文本内容，因此需要在exceptions = ['Markdown-Picture-Resize-and-Location.md', 'templete.md']增加排除项目
¶ 1.3 公式Latex
wiki.js使用一个通用但是精简的渲染模块katex，因此有些公式是不支持的，
- 请使用aligned，而不是aligned/align*
- 请使用gathered，而不是gather/gather*
katex渲染与markdown-it-attrs冲突，其中之一表现是公式中{ {x} }的渲染会出问题，还有行内公式会出问题，除此之外还有很多奇奇怪怪的问题。为了一劳永逸可以修改源文件，disable掉markdown-it-attrs，副作用是图片的{.align-center}不再起作用。
图片居中替代方法，可以在Adminstration-Theme - Code injection - CSS Overload 中输入以下代码，实现全局图片居中
.contents img { display: block; margin: 0 auto; }
禁用的markdown-it-attrs方法的原帖链接：
在windows版本中，这4个文件中只有后2个可以更改，实测可以解决问题：
¶ 1.4 mardown语法
两个~：wiki.js 下角标（空格破坏格式识别）；而ob中原样显示；
两个=：wiki.js中原样显示；ob高亮；
缩进：wiki.js 中缩后公式不支持换行；ob中支持；替代解决方案是一行写下全部或者就根本无需缩进。
¶ 2 导入流程
¶ 2.1 Python脚本
Download Link: ob2wikijs.py
¶ 2.2 GitHUB导入配置
首先按照GitHub-Guide完成Git的安装，在wiki.js中Adminstration - Storage - Git 完成如下配置，官方的指导链接为：
- Authentication Type: ssh
- Repository URI:
[email protected]:RingsGit/analog-ic-wiki.git - Branch: main
- SSH Private Key Mode: path
- A SSH Private Key Path:
C:\Users\lumin\.ssh\id_rsa - Verify SSL Certificate: True
- Default Author Email: [email protected]
- Default Author Name: RingsGit
- Local Repository Path: ./data/repo/analog-ic-wiki
首先在PowerShell中安装pip install gitpython，这样可以直接Python实现先拉pull再推的操作
¶ 2.3 本地导入
- 准备好obsidian的内容，注意文章标题不含空格
.等问题； - 直接执行 ob2wikijs.py
- 脚本中的process_import()将在 wiki.js | storage 自动执行local import
- 如果是 Local Filesystem，执行 Import Everything
- 如果是 GitHub，分别执行 Purge Local Repository | Force Sync | Import Everything