![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
|
LinuxServer? なぜ pukiwiki から wiki.js へ移行しようと思ったか 1 †
なぜ pukiwiki から wiki.js へ移行しようと思ったか 2 †
公式リンク(top) †
Editor - Markdown †
Editor - MarkDown(日本語) †
前提 †環境 †
他に検討したもの †
構築 †構築コマンド †
MariaDBへ切り替え †なぜ？ †
参考サイト †MariaDB のインストールと自動起動設定,起動 †sudo apt install mariadb-server sudo apt start mariadb sudo apt enable mariadb 初期設定 †sudo mysql_secure_installation
(MariaDB) wiki.js用ユーザーの作成とデータベースの作成 †
wiki.js の変更 †
db: type: mariadb # PostgreSQL / MySQL / MariaDB / MS SQL Server only: host: localhost port: 3306 user: wikijs pass: password db: wikijs ssl: false backup †こちらを参照(mysql):/310-Linux/313-LinuxServer/mysql 設定変更 †config.yml の場所,Path †
SSL(TLS)化 †
# --------------------------------------------------------------------- # SSL/TLS Settings # --------------------------------------------------------------------- # Consider using a reverse proxy (e.g. nginx) if you require more # advanced options than those provided below. ssl: #enabled: false enabled: true port: 3443 # Provider to use, possible values: custom, letsencrypt provider: custom #provider: letsencrypt # ++++++ For custom only ++++++ # Certificate format, either 'pem' or 'pfx': format: pem # Using PEM format: # key key: /etc/pki/tls/certs/server.key # 証明書 cert: /etc/pki/tls/certs/server.crt # Using PFX format: #pfx: path/to/cert.pfx # Passphrase when using encrypted PEM / PFX keys (default: null): passphrase: null # Diffie Hellman parameters, with key length being greater or equal # to 1024 bits (default: null): dhparam: null # ++++++ For letsencrypt only ++++++ domain: wikijp.tar3.net subscriberEmail: hogehoge@unyaunya.net dataPAth: の変更 †
faviconの変更 †
Web画面からの設定変更 †全般設定 †
言語 †
ナビゲーション †
グループ †
アナリティクス †
セキュリティ †
記事の作成関連 †markdown †User's manual(公式) †
書式の設定方法(参考サイト) †
designet(参考サイト) †ブロッククォート(箇条書きと組み合わせない場合、使用可能です) †> スタイルなし eee
> .is-info aaa
{.is-info}
> .is-succsess bbb
{.is-success}
> .is-warning ccc
{.is-warning}
> .is-danger ddd
{.is-danger}
> スタイルなし eee
> .is-info aaa
{.is-info}
> .is-succsess bbb
{.is-success}
> .is-warning ccc
{.is-warning}
> .is-danger ddd
{.is-danger}
脚注 †This sentence[^1] needs a few footnotes.[^2] [^1]: A string of syntactic words. [^2]: A useful example sentence. This sentence[^1] needs a few footnotes.[^2] [^1]: A string of syntactic words. [^2]: A useful example sentence. キーボード,<kbd></kbd> †<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>o</kbd> tabset †### タブ {.tabset}
#### タブ aaa
タブの記事
#### タブ bbb
タブの記事2
### タブ {.tabset}
#### タブ aaa
タブの記事
#### タブ bbb
タブの記事2
メディア資産(画像など)の管理 †
前提条件 †
関連情報は3つ †
table の desc 情報 †
概要 †
場面ごとの変更方法(MariaDBでの変更方法) †
共通 †
use wikijs
メディア資産で表示されるフォルダ名の変更 †
メディア資産で表示されるフォルダ名の削除 †
メディア資産で表示される画像ファイルのフォルダ移動 †
Microsoft Visual Studio Code(vscode)を使用 †おすすめ拡張機能 †
使い方(Markdown Preview Enhanced) †
使い方(Markdown All in One) †
vscode 共通機能の設定についてはこちら †
(vscode) 目次の作成方法 †
Log (ログ) の出力,確認 †rsyslog のインストール †sudo apt install rsyslog daemonの実行と再起動時の自動実行設定 †``` sudo systemctl start rsyslog sudo systemctl enable rsyslog ``` log の確認 †``` cat /var/log/syslog ```
新規ユーザーや新規コメントの確認 †
elasticsearchの導入 †
install †
設定 †メモリ関連の設定 †``` sudo vim /etc/elasticsearch/jvm.options ```
-Xms512m -Xmx512m ```
``` # ======================== Elasticsearch Configuration ========================= # # NOTE: Elasticsearch comes with reasonable defaults for most settings. # Before you set out to tweak and tune the configuration, make sure you # understand what are you trying to accomplish and the consequences. # # The primary way of configuring a node is via this file. This template lists # the most important settings you may want to configure for a production cluster. # # Please consult the documentation for further information on configuration options: # https://www.elastic.co/guide/en/elasticsearch/reference/index.html # # ---------------------------------- Cluster ----------------------------------- # # Use a descriptive name for your cluster: # #cluster.name: my-application cluster.name: wikijs # # ------------------------------------ Node ------------------------------------ # # Use a descriptive name for the node: # #node.name: node-1 # # Add custom attributes to the node: # #node.attr.rack: r1 # # ----------------------------------- Paths ------------------------------------ # # Path to directory where to store the data (separate multiple locations by comma): # path.data: /var/lib/elasticsearch # # Path to log files: # path.logs: /var/log/elasticsearch # # ----------------------------------- Memory ----------------------------------- # # Lock the memory on startup: # #bootstrap.memory_lock: true # # Make sure that the heap size is set to about half the memory available # on the system and that the owner of the process is allowed to use this # limit. # # Elasticsearch performs poorly when the system is swapping the memory. # # ---------------------------------- Network ----------------------------------- # # By default Elasticsearch is only accessible on localhost. Set a different # address here to expose this node on the network: # #network.host: 192.168.0.1 # # By default Elasticsearch listens for HTTP traffic on the first free port it # finds starting at 9200. Set a specific HTTP port here: # #http.port: 9200 # # For more information, consult the network module documentation. # # --------------------------------- Discovery ---------------------------------- # # Pass an initial list of hosts to perform discovery when this node is started: # The default list of hosts is ["127.0.0.1", "[::1]"] # #discovery.seed_hosts: ["host1", "host2"] # # Bootstrap the cluster using an initial set of master-eligible nodes: # #cluster.initial_master_nodes: ["node-1", "node-2"] # # For more information, consult the discovery and cluster formation module documentation. # # ---------------------------------- Various ----------------------------------- # # Allow wildcard deletion of indices: # #action.destructive_requires_name: false #----------------------- BEGIN SECURITY AUTO CONFIGURATION ----------------------- # # The following settings, TLS certificates, and keys have been automatically # generated to configure Elasticsearch security features on 07-06-2025 05:58:45 # # -------------------------------------------------------------------------------- # Enable security features xpack.security.enabled: false xpack.security.enrollment.enabled: false # Enable encryption for HTTP API client connections, such as Kibana, Logstash, and Agents xpack.security.http.ssl: enabled: false keystore.path: certs/http.p12 # Enable encryption and mutual authentication between cluster nodes xpack.security.transport.ssl: enabled: false verification_mode: certificate keystore.path: certs/transport.p12 truststore.path: certs/transport.p12 # Create a new cluster with the current node only # Additional nodes can still join the cluster later cluster.initial_master_nodes: ["serverName"] # Allow HTTP API connections from anywhere # Connections are encrypted and require user authentication http.host: 0.0.0.0 # Allow other nodes to join the cluster from anywhere # Connections are encrypted and mutually authenticated #transport.host: 0.0.0.0 #----------------------- END SECURITY AUTO CONFIGURATION ------------------------- ``` elasticsearchデーモンの起動と自動起動設定 †``` sudo systemctl restart elasticsearch sudo systemctl enable elasticsearch ``` 動作確認 †
wiki.js側の設定 †
動作確認して完了です。 †
refresh_interval の時間を変更する。 †
pukiwikiからの移行(置換概要) †最初に †
* -> #(数の多い方からやっていきます) †
+ -> + †
「----」 -> Tab へ †
ハッシュタグの消去 †
リンクの変更 †
改行 †
-- -> tabへ †
template †
```
```
あまりにも面倒なので python でプログラムを組みましたw †
class CheckTabSharpClass: def __init__(self) -> None:
self.tabCharacter = ""
self.sharpAsteriskFlag = False
self.tableFlag = False
def check( \
self \
,line\
):
afterReplaceCharacter=""
beforeReplaceCharacter=""
if line and line[0] in {"+", "-"}:
beforeReplaceCharacter = line[0]
if line and line[0] == "+":
afterReplaceCharacter = "+"
else:
afterReplaceCharacter = line[0]
beforeReplaceOrderList = ""
orderCount=0
newListLine=""
self.tabCharacter = ""
for characterOrder in line:
if characterOrder==" ":
break
else:
if orderCount==0:
beforeReplaceOrderList = characterOrder
newListLine = characterOrder.replace(beforeReplaceCharacter,afterReplaceCharacter)
else:
beforeReplaceOrderList += characterOrder
newListLine = "\t" + newListLine
self.tabCharacter += "\t"
orderCount += 1
line = line.replace(beforeReplaceOrderList,newListLine)
if line and line[0]=="|":
self.tableFlag=True
else:
self.tableFlag=False
if line and line[0]=="*":
line = line.replace("*","#")
self.tabCharacter=""
self.sharpAsteriskFlag=True
elif self.tableFlag==False:
self.sharpAsteriskFlag=False
return line def checkAddSpace(line): headerSpace=""
spaceFlag= False
beforeReplace=""
for character in line:
if character==" ":
spaceFlag = True
headerSpace += character
break
elif character.startswith('*') \
or character.startswith('+') \
or character.startswith('-') \
:
pass
else:
beforeReplace = headerSpace
headerSpace = headerSpace + " "
break
headerSpace += character
if spaceFlag == False:
line= line.replace(beforeReplace,headerSpace)
return line class CreateTabTextClass: def __init__(self) -> None:
self.codeFlag=False
self.codeHeadTab=""
self.tableFlag=False
def CreateTabText( \
self \
,eachLine \
,checkTabSharpClass \
):
tabCharacter=""
returnEachLine=""
returnEachLine=eachLine
if checkTabSharpClass.sharpAsteriskFlag==False \
and checkTabSharpClass.tableFlag==False:
tabCharacter="\t"
self.codeHeadTab=""
if eachLine.startswith(" "):
if self.codeFlag == False:
self.codeHeadTab = tabCharacter + checkTabSharpClass.tabCharacter + "```\n"
returnEachLine = self.codeHeadTab + tabCharacter + checkTabSharpClass.tabCharacter + eachLine[1:]
self.codeFlag=True
elif eachLine.startswith(' ')==False \
and self.codeFlag==True :
returnEachLine = self.codeHeadTab + tabCharacter + checkTabSharpClass.tabCharacter + "```\n" + eachLine
self.codeFlag=False
if eachLine.replace("\t","").startswith("|"):
tableSeparate="|"
if self.tableFlag==False:
for pipeCount in range(1, eachLine.count("|")):
tableSeparate+="-|"
returnEachLine= tabCharacter + checkTabSharpClass.tabCharacter + eachLine \
+ tabCharacter + checkTabSharpClass.tabCharacter + tableSeparate + "\n"
self.tableFlag=True
else:
returnEachLine= tabCharacter + checkTabSharpClass.tabCharacter + eachLine
elif self.tableFlag==True \
and eachLine.replace("\t","").startswith("|")==False \
:
self.tableFlag=False
return returnEachLine class ConvertImgrClass: def convert(self, argEachLine):
eachLine=argEachLine
afterSplitComma=[]
afterSplitSlash=[]
imgFileName=""
afterSplitComma=eachLine.split(",")
afterSplitSlash=afterSplitComma[0].split("/")
imgFileName=afterSplitSlash[-1].lower()
eachLine="!["+imgFileName+"](%ImgFilePath%/"+imgFileName+")\n" return eachLine class TransFormLineClass: def transform_line( \
self \
, inputLines \
):
try:
checkTabSharpClass = CheckTabSharpClass()
createTabTextClass = CreateTabTextClass()
convertImgrClass = ConvertImgrClass()
eachLine=""
outputText=""
for line in inputLines:
eachLine=line
if \
eachLine.startswith('*') \
or eachLine.startswith('+') \
or eachLine.startswith('-') \
or eachLine.startswith('|') \
:
#Spaceが無い場合に追加
if eachLine.startswith('|')==False:
eachLine = checkAddSpace(eachLine)
#Tabと * の処理
eachLine = checkTabSharpClass.check(eachLine)
eachLine=re.sub(r" \[.........\]", "", eachLine)
eachLine=re.sub(r"\[.........\]", "", eachLine)
eachLine=createTabTextClass.CreateTabText( \
eachLine \
, checkTabSharpClass \
)
if "&imgr" in eachLine:
eachLine=convertImgrClass.convert(eachLine)
eachLine=eachLine.replace("~","")
eachLine=eachLine.replace("[[","[")
eachLine=eachLine.replace(":http","](http")
eachLine=eachLine.replace("]]",")")
eachLine=eachLine.replace("''","**")
eachLine=eachLine.replace("&br;","<br>")
eachLine=eachLine.replace("|h","|")
outputText+=eachLine
del createTabTextClass
del checkTabSharpClass
del convertImgrClass
return outputText
except:
import traceback
traceback.print_exc()
ファイル単位で処理する場合 †inputFileName="input.pukiwiki" outputFileName="output.wikijs" with open('pukiwikiWikijsSource\\'+inputFileName, 'r', encoding='utf-8') as infile, \ open('pukiwikiWikijsSource\\'+outputFileName, 'w', encoding='utf-8') as outfile:
transFormLineClass = TransFormLineClass()
inputLines=[]
for line in infile:
inputLines.append(line)
outputText=""
outputText=transFormLineClass.transform_line(inputLines)
if outputText is not None and isinstance(outputText, str):
outfile.write(outputText)
del transFormLineClass
```
participant main participant TransFormLineClass participant CheckTabSharpClass participant CreateTabTextClass Activate main note right main inputFileName="input.pukiwiki" outputFileName="output.wikijs" open input.pukiwiki open output.wikijs end note loop foreach line in input file note right main inputLines.append(line) end note end note right main outputText=transFormLineClass.transform_line(inputLines) end note main -> TransFormLineClass: transform_line(self, inputLines) Activate TransFormLineClass note right TransFormLineClass checkTabSharpClass = CheckTabSharpClass() createTabTextClass = CreateTabTextClass() eachLine="" outputText="" end note TransFormLineClass -> CheckTabSharpClass activate CheckTabSharpClass TransFormLineClass -> CreateTabTextClass activate CreateTabTextClass loop foreach line in inputLines
note right TransFormLineClass
eachLine = line
end note
alt eachLine.startswith('*') or eachLine.startswith('+') or eachLine.startswith('-') or eachLine.startswith('|')
alt eachLine.startswith('|')==False
TransFormLineClass -> main: checkAddSpace
note right TransFormLineClass
+ # - のあとに半角スペースが無ければ挿入
end note
activate main main --> TransFormLineClass: eachLine deactivate main end TransFormLineClass -> CheckTabSharpClass: check(eachLine) note right CheckTabSharpClass afterReplaceCharacter="" beforeReplaceCharacter="" end note alt line and line[0] in {"+", "-"}
note right CheckTabSharpClass
+ を + へ変更
beforeReplaceOrderList = "" orderCount=0 newListLine="" end note loop characterOrder in line alt characterOrder==" " note right CheckTabSharpClass 何文字目かの文字(foreach)が、半角スペース(もう終わりなら) break end note else alt orderCount==0 note right CheckTabSharpClass 文字が - か + で、かつ最初の文字の時 beforeReplaceOrderList = characterOrder newListLine = characterOrder.replace(beforeReplaceCharacter,afterReplaceCharacter) end note else note right CheckTabSharpClass 文字が - か + で、かつ2文字目以降(タブの追加) beforeReplaceOrderList += characterOrder newListLine = "\ t" + newListLine self.tabCharacter += "\ t" end note end end note right CheckTabSharpClass orderCount += 1 end note end note right CheckTabSharpClass line = line.replace(beforeReplaceOrderList,newListLine) end note end alt line and line[0]=="|" note right CheckTabSharpClass self.tableFlag=True end note else note right CheckTabSharpClass self.tableFlag=False end note end alt line and line[0]=="*"
note right CheckTabSharpClass
line = line.replace("*","#")
self.tabCharacter=""
self.sharpAsteriskFlag=True
end note
else self.tableFlag==False
note right CheckTabSharpClass
self.sharpAsteriskFlag=False
end note
end
CheckTabSharpClass --> TransFormLineClass: eachLine=line
note right TransFormLineClass
ハッシュタグの消去
end note
end
TransFormLineClass -> CreateTabTextClass:createTabText(eachLine, checkTabSharpClass) note right CreateTabTextClass tabCharacter="" returnEachLine="" returnEachLine=eachLine end note alt checkTabSharpClass.sharpAsteriskFlag==False note right CreateTabTextClass tabCharacter="\ t" end note end alt checkTabSharpClass.tableFlag==False note right CreateTabTextClass tabCharacter="\ t" end note end alt self.eachLine.startswith(" "):
alt self.codeFlag == False
note right CreateTabTextClass
self.codeHeadTab = tabCharacter + "```\n"
end note
end
note right CreateTabTextClass
returnEachLine = self.codeHeadTab + tabCharacter + "" + eachLine[1:]
self.codeFlag=True
end note
else self.eachLine.startswith(' ')==False and self.codeFlag==True
note right CreateTabTextClass
returnEachLine = tabCharacter + "```\n" + eachLine
self.codeFlag=False
end note
end
alt eachLine.replace("\ t","").startswith("|")
note right CreateTabTextClass
tableSeparate="|"
end note
alt eachLine.replace("\t","").startswith("|")
note right CreateTabTextClass
tableSeparate="|"
end note
loop pipeCount in range(1, eachLine.count("|"))
note right CreateTabTextClass
tableSeparate+="-|"
end note
end
note right CreateTabTextClass
returnEachLine= tabCharacter + checkTabSharpClass.tabCharacter + eachLine \
+ tabCharacter + checkTabSharpClass.tabCharacter + tableSeparate + "\n"
self.tableFlag=True
end note
else
note right CreateTabTextClass
returnEachLine= tabCharacter + checkTabSharpClass.tabCharacter + eachLine
end note
end
else self.tableFlag==True and eachLine.replace("\t","").startswith("|")==False
note right CreateTabTextClass
self.tableFlag=False
end note
end
CreateTabTextClass --> TransFormLineClass:returnEachLine note right TransFormLineClass
eachLine=eachLine.replace("~","")
eachLine=eachLine.replace("[[","[")
eachLine=eachLine.replace(":http","](http")
eachLine=eachLine.replace("]]",")")
eachLine=eachLine.replace("''","**")
outputText+=eachLine end note end TransFormLineClass --> main: outputText deActivate CreateTabTextClass deActivate CheckTabSharpClass deActivate TransFormLineClass note right main outfile.write(outputText) end note @enduml ``` +  その他 †Visual Editor と Markdown 比較と感想 †Visual Editorの長所 †
Markdownの長所 †vs codeでの編集が可能。 (おまけ) なぜか vim をインストール後、かつsshの状態で、マウス右クリックしても貼り付けできない †
コメントをフルオープンにした場合、どれくらいスパムが来るのか検証 †
upgrade †
|
