山城止境

長草長出了機器人

Soon Yang — Thu, 07 Sep 2023 20:12:47 GMT

下午工作時突然看到手機不停跳通知
這個一向只有我自己在自言自語的部落格，居然有人留言！

...... 瞟了一眼，嗯，果然是機器人😂😂😂

這個機器人幾乎在我的每一篇舊文下都留了 3～6 則毫無意義的留言
本來想說要不要留下來做紀念，後來覺得還是
我寂寞寂寞就好，就全部刪掉了

P.S. 有空來做個簡單的留言驗證好了
- P.S. 雖然這麼說，但我前面文章也數次許下類似的承諾
  - P.S. 剛好趁著刪機器人留言稍微又 review 了一下自己以前的廢文
    - P.S. 現在沒人在用 P.S. 這種方式寫文章了吧 (老

[Python] Miniconda

Soon Yang — Wed, 16 Aug 2023 19:37:21 GMT

剛接觸 miniconda，先開一篇預留點筆記位置~

https://docs.conda.io/projects/conda/en/stable/commands/index.html
https://stackoverflow.com/questions/42309333/explanation-of-different-conda-channels
Python virtualenv and venv dos and don’ts
https://www.infoworld.com/article/3306656/python-virtualenv-and-venv-dos-and-donts.html

[Godot] Your first 3D game 練習

Soon Yang — Tue, 01 Aug 2023 16:29:17 GMT

前一個 2D Game 初步照著教學 step by step 完成了

儘管其中還有許多不明所以的地方
例如一些計算速率的數學問題 ~~不會就是不會~~

因為幾乎還沒啃過官方文件就直接進入了新手範例教學
整體編輯器、Godot 元件都還有大量未知的部分

嘗試了匯出 Windows、Html5 平台檔案出來執行
也看到 Build 功能中仍有許多水很深的設定需要了解

無論如何，先繼續往下一個 3D 教學前進 ...

教學網址
https://docs.godotengine.org/en/stable/getting_started/first_3d_game/index.html

這次學乖了先切換了一下 en 語系，不幸的是上面明確地寫了這份文件是 outdated，還沒有針對 4.1 版做更新。

沒關係我們還是先照著試試看：

20230813 補充:

後來實作時有比對了一下 en / zh-CN 文件，發現英文版應該還是有更新成 4 版的語法，
可能只是沒有經過完整校對，還是寫了警語在上面，所以後來我就直接看英文版了。

因此這篇筆記主要就不是針對 3 / 4 版之間的差異，而是我個人覺得想記錄的一些要點

Setting up the game area

第一步是下載相關 Assets
與《My First 2D Game》不同的是，這份教學 Assets 內包含了一個現成的 Project。
2D 範例則是從自己 New 一個 Proect 開始
Import Project 直接選 .zip (不需解壓縮)，匯入時會提示這是一份 Godot 3 專案
接下來會有一些選項要你決定是否嘗試轉換成 Godot 4 專案、轉換不能反悔要記得備份等警語

Player scene and input actions

Moving the player with code

Vector 的 Normalize
- 這裡有段程式碼在處理收到玩家移動指令 => 改變角色的位移
  其中呼叫了 Vector3.normalized()
```
if Input.is_action_pressed("move_right"):
    direction.x += 1    // 按右的話 x 軸 +1
if Input.is_action_pressed("move_left"):
    direction.x -= 1
if Input.is_action_pressed("move_back"):
    direction.z += 1    // 按下的話 z 軸 +1
if Input.is_action_pressed("move_forward"):
    direction.z -= 1

if direction != Vector3.ZERO:
    direction = direction.normalized()
    $Pivot.look_at(position + direction, Vector3.UP)
```
  並有一段 Tip 說：
  
  In case the player presses, say, both W and D simultaneously, the vector will have a length of about 1.4. But if they press a single key, it will have a length of 1. We want the vector's length to be consistent, and not move faster diagonally. To do so, we can call its normalize() method.
  
  查了一下似乎是遊戲中很常見的移動速率控制 (不論 2D、3D)。
  
  大概意思是當玩家只按了「上」或「右」時，角色往「上」或「右」移動速度都是 1，
  但如果玩家同時壓了「上 + 右」，會產生一個往右上約 1.4 的速率，
  (想像一個邊長 1 的正方形，中間斜對角線是根號 2，大約是 1.4)
  
  結果就是玩家斜向移動的話會比較快，而這可能不是我們要的結果。
  因此一般會提供一個 Normalize 方法，讓往任何方向移動的速率都固定是 1
  
  像剛剛說的往右上移動，Normalize 後 Vector 大約是 (0.7, 0.7)
- 從 gamedev.net 偷的圖
分割 Viewport
- Godot 在 3D View 提供最多分割成 4 個畫面，方便從不同視角觀察世界
- 按畫面右上的 View 選擇，或是快速鍵 Ctrl + (Alt) + 1~4

Designing the mob scene

在處理例如 Mob 物件的銷毀 (離開畫面可視範圍後就可以刪除物件、釋放相關記憶體及資源)。為了避免系統在執行垃圾回收時造成畫面卡頓，可以採用所謂 pooling 的方式
具體上是建立一個 array 並預先產生裡面的物件，以及一些 reuse 機制
- 但在用 C#、Lua 等有垃圾回收機制的語言才需要，GDScript 處理方式不同不需要
  - 詳細以後有機會再研究

Spawning monsters

一些 3D View 的操作 Tips
- 可以用鍵盤右邊數字鍵切換視角 (類似 Blender)
- 移動物件時可以按 y 切換 snap 依附模式，讓物件在 Grid 上對齊格線
- ctrl + D 可以複製物件

Jumping and squashing monsters

To be continued ...

[Godot] Your first 2D game 練習

Soon Yang — Mon, 31 Jul 2023 12:24:47 GMT

Godot 是一個年紀很輕的開源遊戲引擎，最近試著接觸看看，查詢資料時發現前幾個月 Godot 做了一次大版本更新 Godot 4，整個引擎重寫過。

但原本打算做為 LTS 版本的 3.X 版，可能因為使用者眾多，聽說後續又從 4.X 移植了些新功能回去，變成了雙版本同時發展。

以上資訊沒有經過很嚴謹的查核 XD

因為初學想練習，不疑有它就選了 4 版，
引擎本體非常精巧，只有一個 113 MB 的 .exe 執行檔，免安裝！

不過在按照官網文件《您的第一個 2D 遊戲》實作時，遇到了一些語法、build-in 物件找不到的問題，後來發現是 3.X 版與 4.X 版的語法有落差。

比對了一下官網教學文件，zh-TW / zh-CN 版沒更新，en 版則有註明已更新至 for Godot 4.1。

所以這篇是稍微記錄一下，如果一步步照著中文教學走可能會卡住的地方。

Setting up the project

Project Setting
- 要調整畫面寬高，到 Display => Window
  - 3版參數名稱 Size: Width / Height
  - 4版參數名稱 Size: Viewport Width / Viewport Height
- Stretch 調整畫面拉伸設定
  - 3版 Mode 選項下拉選單要選 2d
  - 4版 Mode 選項下拉選單要選 canvas_items

Creating the player scene

對 Player Node 新增子 Node AnimatedSprite (3版) => AnimatedSprite2D (4版)
在 AnimatedSprite2D 的 Inspector (屬性檢視器) 找到 Frames (3版) => Sprite Frames (4版)

Coding the player

要將 script 中的變數「匯出」(能在 inspector 面板設定) 的語法有差異
- export var speed = 400 (3版)
- @export var speed = 400 (4版)
在 inspector 面板設定 Player 被敵人碰撞的 Signal
- body_entered(body: Node) (3版)
- body_entered(body: Node2D) (4版)
在 body_entered 內要觸發 hit Signal 的語法有變，但 3 版寫法也還能用
- emit_signal("hit") (3版, 但4版也可用)
- hit.emit() (4版)

Creating the enemy

新增 Mob 的子 Node VisibilityNotifier2D (3版) => VisibleOnScreenNotifier2D (4版)

設定 Mob 移動動畫隨機三選一播放的語法不同 (要取得 sprite 的所有 frames name 後播放)

3版

$AnimatedSprite.playing = true
var mob_types = $AnimatedSprite.frames.get_animation_names()
$AnimatedSprite.animation = mob_types[randi() % mob_types.size()]

4版

var mob_types = $AnimatedSprite2D.sprite_frames.get_animation_names()
$AnimatedSprite2D.play(mob_types[randi() % mob_types.size()])

The main game scene

在 Main 場景下新增子 Node Position2D (3版) => Marker2D (4版)
在 Main 場景的 script 頂部要 export Mob 場景的語法不同
- export(PackedScene) var mob_scene (3版)
- @export var mob_scene: PackedScene (4版)
在 _on_mob_timer_timeout 事件中 new 一個 Mob，要在 MobPath(Path2D) 指定隨機出生點的語法不同
- mob_spawn_location.offset = randi() (3版)
- mob_spawn_location.progress_ratio = randf() (4版)
TIP 中說在計算角度時，如果需要在弧度 radians 跟角度 degrees 做轉換，方法名稱不同
- deg2rad()、rad2deg() (3版)
- deg_to_rad()、rad_to_deg() (4版)
3版在 Main._ready() 時有加上 randomize()，說才能確保每次 random 產生的隨機值都不同，但4版文件沒提醒要加這句了

Heads up display

要更換 Label 的字體，在 Inspector 的 Theme Overrides 區塊內
- 在 Fonts 選 New DynamicFont 後再對 Font Data 選 Load 再選擇字型檔 (3版)
- 在 Fonts 選 Load 再選擇字型檔 (4版)
設定好 Fonts 後，3版有教學可以在 Font 下拉選單選 copy，再直接到另一個 Control 的 Font 屬性選 paste。4版教學沒提到這點
設定 Layout 時 3／4版介面不同 (4版: Anchors Preset)
Label 的文字對齊 (align) 3版只能設定 Align=Center，4版再細分成 Horizontal Alignment 及 Vertical Alignment
文字換行 Autowrap 3版只能選啟用，4版有更多 mode 可選: Off, Arbitrary, Word, Word(Smart)
yield 語法在 4版已被 await 取代
- yield($MessageTimer, "timeout") (3版)
- await $MessageTimer.timeout (4版)

Finishing up

加入音效檔，3版沒有這段補充，4版有:
- audio 檔在 import 時預設 Loop 都是 disabled 的，想要不間斷持續播放，在 Stream 下拉選單點選 Make Unique，然後再點一次 Stream 檔、勾選 Loop

興沖沖買了個網域，但...

Soon Yang — Mon, 19 Apr 2021 16:25:31 GMT

因為

這個 (沒人看) 的 Blog 因為是用 Azure Web App 架設的
網址一直是預設的 soon.azurewebsites.net

這幾天剛好看到 Godaddy 有優惠活動

.tw 域名特價第一年只要 NT99

心想給這個玩票性質的站台一個名份也不錯
(第二年恢復原價了再說 ... )

而且自從幾個月前註冊了 Godaddy 帳號後
也一直還沒下手，買一個專屬於自己的域名

心想一個工程師總是要有一二次這種經驗 (哪種?
就興沖沖跑去 Godaddy 下訂了一個喜歡的域名

soon.tw 這麼熱門的當然是早就被買走了

不過這裡就不特別說明最後買了哪個域名
因為暫時用不到了...QQ

另外也稍微看了一下網路討論，Godaddy 是美國公司
所以跟他們買算是海外消費

可以的話

請挑選海外消費回饋較高的信用/簽帳卡
網路上很多促銷代碼，可以稍微 Google 找 Godaddy promo code 輸入看看有沒有能用的

我這次購買好像是因為 .tw 優惠方案的關係
輸入網路上找到的一些 30% discount code 都沒效
可能方案本身已經計算為最優惠了

買域名的部分

沒什麼特別好說的，就是

註冊 Godaddy 帳號
搜尋想要、而且沒有被買走的域名，加入購物車
結帳刷卡

結帳前會有些步驟，詢問你要不要順便購買一些加值服務，會比較便宜
這些就看個人需求

另外有一點可能稍微要注意
域名購買者的部分資訊會被揭露在 WHOIS

至少我在 Godaddy 買完域名後，預設基本隱私權保護開啟的狀態下

WHOIS 查詢這個域名，還是顯示了我在 Godaddy 註冊的英文姓名 + Email
如果很在意自己隱私的人請再自己斟酌

接著要設定域名

這裡我 ~~大意了沒有閃~~ 出了個包
心想買好了域名，當然先來查一下網路教學看怎麼設定

讚喔！微軟有官方教學文件

Tutorial: Map an existing custom DNS name to Azure App Service

繼續往下讀

The app's current tier is highlighted by a blue border. Check to make sure that the app isn't in the F1 tier. Custom DNS isn't supported in the F1 tier.

重點

Custom DNS isn't supported in the F1 tier.

.......................

對不起孩子 ... 我是個蹭免費仔，到現在還在用 F1 (Free) Tier

看了一下如果要升級最便宜的付費 Tier

應該就是這個 D1 了

預估每月 NT 285，一年大概 NT 3420

這...也不能說是很貴
如果想認真經營一個自己的技術部落格(非營利)，應該還算是滿合理的價位

只是

這裡目前單純就是自己閒暇之餘，用來練習寫網站、跟自己自言自語的地方
這筆花費還是決定先省著吧 😅

孩子，當為父有一日財富自由了
會回來給你一個名份的 (抱)

對了我還得記得明年取消那個域名的自動續約

不然第二年起好像也要扣 NT 1000 多 ...

ref: 有朝一日會用到的 Azure Web App Custom Domain 設定教學

Tutorial: Map an existing custom DNS name to Azure App Service
https://docs.microsoft.com/zh-tw/azure/app-service/app-service-web-tutorial-custom-domain
替 Azure 的 App Service 網站設定自訂網域
https://dotblogs.com.tw/jamestsai/2019/08/17/How-to-Bind-Self-Domain-to-Azure-Web-App-Service
[Azure]Web App自訂網域與憑證申請
https://www.dotblogs.com.tw/jamesfu/2020/02/05/custom_domain_ssl

TinyMCE 到 SimpleMDE (中？)

Soon Yang — Wed, 17 Feb 2021 18:15:31 GMT

距離上一次說要把編輯器換成 SimpleMDE 已經是去年3月的事情了

趁著這次春節，終於鼓起勇氣來動手了

1. 更換 SimpleMde

如同上次所說，我參考了這篇 IT 鐵人賽這位暐翰大大的系列文章
不過雖然有參考文章，可能因為我自己也亂改客製了 MiniBlog.Core 不少東西
在修改過程中還是遭遇到了許多不明問題，所以後來直接去爬這位大大放在 Github 的 Demo
依序看過幾個相關的 Commits，才知道實際上的修改步驟，以及幾個關鍵的 html 元素與 editor 之間的互動
最後才終於把編輯器從 TinyMCE 換成 SimpleMDE
實際存到後端的文章，本來有一個 Content 欄位會儲存 Html 原始碼
現在會多一個 MarkDownContent，儲存了 markdown 語法的文章內容
在顯示與更新內容時，會由 SimpleMde 做轉換

2. CSS 樣式走鐘

換成 markdown 編輯文章後，發現在編輯器中 preview 的結果很正常
或者說，是比較接近 Github 等網站上看到的樣式
但在存檔後，實際檢視文章時，卻發現原本 Miniblog.Core 預設的樣式，非常不符合預期 XD
但本人算是前端智障，所以在
1. 找出預設 css 檔所在位置、2. 註解部分 css、3. 引入 Github Markdown CSS 檔、4. <code>的顯示改用 highlight.js
過程中又花了不少的時間

3. 上傳圖片

換了 SimpleMDE 之後，發現它內建的 Insert Image 按鈕，作用只是幫你插入這段文字而已
```
![](https:// )
```
這樣我原本串 imgur API，去上傳圖片的動作就失去意義了
(要手動開 imgur 網站上傳，再把網址貼過來)
幸好 SimpleMDE 除了內建的22個按鈕
也允許我們自己另外新增新的按鈕，並自訂要觸發的事件
只不過前端智障如我本人在下，又花了很多時間才處理好這段
- 自訂 toolbar action 觸發自訂事件
- 用 js 產生 input 元素然後 click 它，並監聽 change event，在選擇檔案後會得到 files 物件
- 使用 FormData 及 XMLHttpRequest 的處理方式向後端上傳圖檔
- 在 xhr.onreadystatechange event 中處理
  當 xhr.readyState == XMLHttpRequest.DONE 時
  取出向後端 upload image 的 response (成功時會是一個 imgur 圖檔 url)
- 把檔名組合成 ![](https://xxxxxx.ooo) 的格式，然後再更新回編輯器的 TextArea
好不容易處理完上傳圖片按鈕，但又想到，應該要順便支援
拖曳圖檔 & Ctrl+V 貼上 兩種上傳方式
- 等我大概搞清楚怎麼處理 paste、drop 事件
  以及發現瀏覽器有沙盒相關限制，不能 直接對本機檔案 Ctrl+C 後，直接 Ctrl+V
  然後從 ClipBoardData 取得 Files，又是幾個時辰過去了 ...

4. 其他修正

修改過程中也有陸續改一些之前發現的 bug，或是臨時想到的調整

從首頁檢視文章，畫面最下方會有 <<更舊、更新>> 兩個按鈕

MiniBlog.Core 的分頁邏輯是，最新(最後)一頁是 page = 0
然後往前一頁 (較舊的) 是 page = 1，依此類推

[更新] 按鈕的顯示條件是
```
 @if (currentPage > 0)
 {
     // 顯示 [更新] 按鈕
 }
```
這沒有問題

但是之前有發現一直按 [更舊] 到了第一頁，畫面上還是會顯示 [更舊] 按鈕
而再按下去後，畫面上卻沒有文章了

看了一下原本 prev button 的顯示邏輯是
```
 @model IEnumerable<Post>
 @if (Model.Any())
 {
     // 顯示 [更舊] 按鈕
 }
```
意思大概是，只要目前這頁有文章，就還是要顯示 [較舊] 按鈕
這怪怪的，所以我的調整方式是，後端在取該頁 posts 時，順便多取出下一頁的 posts
(目前設定一頁是 5 篇)
然後把下一頁的 posts.Any() 作為要不要顯示 [更舊] 按鈕的條件，放進 ViewBag 給前端判斷
網頁字體換了思源黑體 Noto Sans TC
目前還不確定這是不是一個好的決定，需要觀察看看效果

其實還想把網站的樣式做一些比較大的調整，但是......前端智障心有餘而力不足
接著又已經春節結束開工啦！下一次更新不知道是什麼時候了 (~~Flag~~)

翻新舊專案是不人道的行為

Soon Yang — Thu, 09 Jul 2020 16:51:54 GMT

最近有個工作上的需求，是要將舊的 ASP.NET MVC 5 + AngularJS (一代) 的 Web 專案

升級到 .NET Core 3.1 + Linux Docker 環境上可以運作的狀態

真的必須說相關的雷實在太多太多了 ... 。

這個血尿過程仍在進行式中，如果我活下去了改天再來更新相關心得 ... 。

下面暫存一些參考過的文章，還有很多在解決過程中沒有留下的，等想起來再補上，或是就 ... 算了。

官方升級指南：Migrate from ASP.NET MVC to ASP.NET Core MVC
Entity Framework 從 6.3 開始支援 .NET Core (目前最新是 6.4.4)
SignalR 相關
- Differences between ASP.NET SignalR and ASP.NET Core SignalR
ASP.NET Core SignalR 不相容舊版的 SignalR javascript client 套件 (client 會收到 405 method not allowed)
前端用 Ajax POST 過來的參數都是 null (或 default，看 type 是什麼)
樂活武士：[ASP.NET Core]Net Core 3.1 API 回傳小寫問題
Bundle & Minify 相關
- 官方文章：Bundle and minify static assets in ASP.NET Core
- 軟體主廚：[食譜好菜] BundleConfig 在 ASP.NET Core 還存在嗎？
Form 表單驗證登入相關
- 高級打字員的技術雲：[ASP.net Core 3.0] 實作 Cookie based 登入機制(CookieAuthentication) 取代ASP.Net Framework的表單驗證(FormsAuthentication)登入
- Will 保哥：如何實作沒有 ASP.NET Core Identity 的 Cookie-based 身分驗證機制

網站升級 .net core 3.1 過程的慘劇

Soon Yang — Sun, 14 Jun 2020 19:33:54 GMT

簡而言之就是遺失資料了 QQ

這裡用的 Miniblog 原本是 .Net Core 2.1 版，前陣子想照著網路上的 migration 教學升到 3.1 版

修改完後在 local 可以順利 run 起來

但透過 azure devops deploy 上 azure web app 後，卻出現 500.30 error

最近比較忙所以一直放著它沒修

今天又抽了點時間來查看，懷疑過各種可能性，包括

azure app service 上的 .net core 版本
azure devops CICD 的設定
project 裡面的 config
也試過不透過 CICD，而是由 visual studio 直接進行 web deploy 來 publish，but

人生最重要的就是這個 but (?)

因為這個 blog 文章是存放在 server 上的 Lite DB 檔案，並在版控上加入 .gitignore 排除來避免覆蓋

再偶爾人工上去 server 備份 ......

然而我剛剛卻直接用 VS 去 deploy，本地的 DB 就覆蓋掉 server 上面的啦 Q__Q

具體上遺失了哪些文章其實我也不記得

只是有股淡淡的哀傷

然後最後發現升級失敗的原因是

[這張圖片遺失了]

Startup.cs 中的 UseKestrel 要拿掉，並改用 UseIISIntegration

因為我的 azure web app 當初是開 windows 系統跑 IIS 的

deploy 上去就會出現這行錯誤

Application is running inside IIS process but is not configured to use IIS server

話說，要看到這行錯誤也不容易

因為不熟悉 azure portal 操作，翻了好多功能才找到如何看 error log 的地方

唉唉又欠了一項債務得還

想個自動化備份 DB 的方式吧

TinyMCE 到 SimpleMDE (前)

Soon Yang — Tue, 17 Mar 2020 04:04:54 GMT

MiniBlog 的預設編輯器是使用 TinyMCE

不過用了幾次下來常常覺得不順手，有時上下移動編輯完一段文字後

在編輯模式看不出問題，存檔送出後才發現常會有文字格式不一致的情況

同一行字有大有小，又得重新編輯

我都懶得檢查產出的 html 所以都直接全選 → clear formatting 來解決

之前架設這個 Blog 參考的鐵人賽文章

他是自行改成用 SimpleMDE 這套編輯器，可支援 markdown 語法

其實 TinyMCE 也有支援類似 markdown 語法的功能叫 text pattern

可以在你輸入特定文字時自動幫你轉換成指定內容

例如兩個星號 ** 變成粗體，這種 markdown-like 的方式

但試用了一下還是相當不順手，於是決定找機會也換成 SimpleMDE 來試試

更換編輯器我自己預想了幾個步驟：

安裝 (npm install 或直接用網路上 cdn 的?)
修改前端頁面引入套件
轉換舊文章格式

新電腦記得裝的軟體

Soon Yang — Thu, 13 Feb 2020 02:43:13 GMT

last updated: 20210420

工作用

Chocolatey

cmd command

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command " [System.Net.ServicePointManager]::SecurityProtocol = 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

GitCredential Manager for Windows (裝Git for Windows 會預設安裝)
- 如何透過GitCredential管理透過HTTP通訊協定存取儲存庫的帳號密碼
VS
- ReSharper
SSMS
VS Code (可登入微軟或 Github 帳號同步設定，我用微軟帳號)
SourceTree
Cmder
Docker Desktop for Windows
Redis Desktop Manager 0.9.3.817
WSL

雜類

Vimium (Chrome extension, 登入會自動同步)
Rocket Dock
OneNote
Joplin (資料加密同步在 dropbox)
Wox
PicPick
Paint.Net
HoneyView
7-Zip
mpc-hc
通訊軟體
Line
Telegram
Skype
Slack
DIscord