Skip to content

Commit

Permalink
Publishing Workspace
Browse files Browse the repository at this point in the history
  • Loading branch information
linonetwo committed Nov 2, 2024
1 parent 323412e commit 284aac4
Show file tree
Hide file tree
Showing 4 changed files with 126 additions and 0 deletions.
40 changes: 40 additions & 0 deletions tiddlers/TidGi Feature Handbook_Create Workspace.tid
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
created: 20241102060818576
creator: 林一二
modified: 20241102061122191
modifier: 林一二
tags: [[TidGi Feature Handbook]]
title: TidGi Feature Handbook/Create Workspace

A brief tutorial on creating public and private workspaces (knowledge bases) in Taiji:

! To create a main knowledge base (as a public knowledge base)

# Open the New Workspace popup box by clicking on the plus + button on the TaiKeeper sidebar
# The ''Create New WIKI'' tab will be checked by default.
# In the ''Parent folder of workspace's folder'', select the path where you wish to store the knowledge base. The default is Desktop, meaning we will create a folder for your notes and this new folder will be placed on the desktop.
# Set the Knowledge Base folder name, e.g. Wiki.
# Ensure that the ''Main Workspace'' option is turned on, this option ensures that your folder can be opened by TaiMarks and will create a configuration file of TaiMarks for you, which can later be used for public distribution if needed.
# Click on the ''Create WIKI'' button to create a main knowledge base at the specified path.

! Creating a Sub-Workspace (Private Knowledge Base)

# Turn on the ''Sub-Workspace'' option when creating a new knowledge base. Sub-knowledge bases must be dependent on a main knowledge base and can be used to store private content.
# Set the knowledge base folder name and save path.
# Specify the location of the main workspace, this is a drop down list of items that need to have been created for the main workspace to be optional. Select a main knowledge base to depend on.
# After creation, the system will automatically create a soft link (shortcut) to the main knowledge base for the sub knowledge base so that the main knowledge base can reference the content in the sub knowledge base. Notes in both knowledge bases will be visible in the main knowledge base at the same time and can reference each other.
# Fill in tags, e.g. ''Private'', and each time you create an entry with a specific tag (e.g. ''Private''), the system will automatically save the content to the appropriate sub-workspace directory according to the rules.
# Click ''Create WIKI'' button, the sub-workspace will be linked to the main workspace while created in the specified location.

With the above steps, you can easily create public and private workspaces in TaiKnowledge for independent management and sharing of different contents.

!!! Principle of Sub-Workspace

TidGi underpinnings work by automatically creating [ext[`$:/config/FileSystemPaths` entries|https://tiddlywiki.com/#Customising%20Tiddler%20File%20Naming]] to defining content storage paths for specific tags.

You can find this file in the main knowledgebase, which is something along the lines of

```tid
[in-tagtree-of[private]]:and[search-replace:g[/],[_]search-replace:g[:],[_]addprefix[/]addprefix[private-wiki]addprefix[/]addprefix[ subwiki]]
```

It is created automatically, so the average user does not need to understand it.
22 changes: 22 additions & 0 deletions tiddlers/TidGi Feature Handbook_Publishing Workspace.tid
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
created: 20241102054211359
creator: 林一二
modified: 20241102060754096
modifier: 林一二
tags: [[TidGi Feature Handbook]]
title: TidGi Feature Handbook/Publishing Workspace

Publicly post the main workspace as a blog and hide private content in the sub-workspaces.

!!! Configure the main knowledge base (public workspace)

# Open TidGi app, right click on the workspace icon in the sidebar and select ''Config Workspace''.
## In the pop-up settings window, there are many configurable items
## In ''Save and Sync'', you can click the switch in front of ''Local Workspace'' to switch to enable ''Synced Workspace''.
## Turning on ''Synced Workspace'' will show you ''Git Identity Credentials'', where you can fill in your GitHub account, email address, branch name, etc. to sync your master workspace to the GitHub public repository. However, if you've already filled this out in [[TidGi Feature Handbook/Cloud Backup/Config Github Backup]], you don't need to do it again here.
# Click the ''Save'' button to complete the configuration.

!!! Creating a Sub-Workspace (Private Workspace)

# The settings for a sub-workspace are basically the same as the main workspace, both can be configured to synchronize to an online Github repository, but you can have it synchronize to a private Github repository
# Set it to be private on Github, or create it as a private repository when you create the repository. This is set up on Github, not on Taichi.
# so that no one can see the private notes you've synced to this repository.
41 changes: 41 additions & 0 deletions tiddlers/太记功能手册_创建工作区.tid
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
created: 20241102045059023
creator: 林一二
modified: 20241102053936440
modifier: 林一二
tags: 太记功能手册
title: 太记功能手册/创建工作区
type:

在太记中创建公开和私有工作区(知识库)的简要教程:

! 创建主知识库(作为公开知识库)

# 点击太记侧边栏上的加号 + 按钮,打开新建工作区弹框
# 默认会选中''创建新WIKI''标签页。
# 在''文件架的父文件夹''中,选择您希望存储知识库的路径。默认为桌面,意思是我们将创建一个文件夹用来放你的笔记,这个新的文件夹将放在桌面上。
# 设置知识库文件夹名称,如 Wiki。
# 确保''主知识库''选项已开启,此选项保证你的文件夹能被太记打开,而且会为你创建太微的配置文件,之后在有需要时可用于公开发布。
# 点击''创建WIKI''按钮,即可在指定路径创建一个主知识库。

! 创建子知识库(私有知识库)

# 在创建新的知识库时,开启''子知识库''选项。子知识库必须依附于一个主知识库,可用于存放私人内容。
# 设置知识库文件夹名称和保存路径。
# 指定主知识库的位置,这是一个下拉列表,需要创建过主知识库才有可选的项目。选择一个要依附的主知识库。
# 创建后,系统会自动为子知识库创建一个指向主知识库的软链接(快捷方式),以便主知识库能够引用子知识库中的内容。两个知识库中的笔记将同时在主知识库里可见,可以互相引用。
# 填写标签,例如''私有'',每次创建带有特定标签(例如''私有'')的条目时,系统会根据规则自动将内容保存到相应的子工作区目录。
# 点击''创建WIKI''按钮,子知识库将链接到主知识库,同时创建在指定位置。

通过以上步骤,您可以轻松地在太记中创建公开和私有的工作区,实现不同内容的独立管理和共享。

!! 子知识库的原理

太微底层通过自动创建 [ext[`$:/config/FileSystemPaths` 条目|https://bramchen.github.io/tw5-docs/zh-Hans/#Customising%20Tiddler%20File%20Naming]]来定义特定标签的内容存储路径。

您可以在主知识库里找到这个文件,内容大致为

```tid
[in-tagtree-of[私有]]:and[search-replace:g[/],[_]search-replace:g[:],[_]addprefix[/]addprefix[private-wiki]addprefix[/]addprefix[subwiki]]
```

它是自动创建的,所以一般用户无需理解。
23 changes: 23 additions & 0 deletions tiddlers/太记功能手册_发布工作区.tid
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
created: 20241102052019352
creator: 林一二
modified: 20241102053918607
modifier: 林一二
tags: 太记功能手册
title: 太记功能手册/发布工作区

公开发布主工作区为博客,并隐藏子工作区里的私有内容。

!! 配置主知识库(公开工作区)

# 打开太记软件,在侧边栏的工作区图标上点右键,选择''工作区设置''。
# 在弹出的设置窗口中,有很多可配置项
## 可以设置''工作区编辑者名称'',用于记录条目的创建者信息。(注意这里的设置会覆盖全局设置)
## 在保存和同步里,可以点击''本地知识库''前面的开关,切换到启用''云端同步知识库''
## 打开''云端同步知识库''后会显示''Git 身份凭证'',你可以在此填写 GitHub 账号、邮箱、分支名称等信息,将主工作区同步到 GitHub 公开仓库。不过如果在[[太记功能手册/云端备份/配置Github备份]]里已经填写过,这里就不用再填写了
# 点击''保存''按钮完成配置。

!! 创建子知识库(私有工作区)

# 子工作区的设置与主工作区基本相同,都可以配置同步到一个在线的 Github 仓库,但是你可以让它同步到一个私有的 Github 仓库
## 在 Github 上设置它是私有,或者在创建仓库时就创建为私有仓库。这个是在 Github 上设置的,不是在太记上设置的
# 这样就没人能看到你同步到这个仓库里的私有笔记了

0 comments on commit 284aac4

Please sign in to comment.