Engineer.log

[Window10] 초기 부팅 후, git : 'git' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다. ...

Mary's log — Fri, 21 Feb 2025 13:37:43 +0900

낡아빠진 13년 전 랩탑에 Window10으로 부팅하고 GitHub의 프로젝트를 Clone하려고

Window Terminal에 `git clone ....` 했더니 아래와 같은 오류가 떴다. ( 그 뒤 로그는 이미 창을 내려서 모루겠넴..)

'git' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다. 이름이 정확한지 확인하고 경로가 포함된 경우 경로가 올바른지 검증한 다음 다시 시도하십시오...

git 커맨드가 안 먹힌다는 뜻이려니 하고 구글링했는데

다른 사람들 블로그 글의 Powershell cmd 등 바꾸라고 해서 했는데도 안되길래

저번에 oh-my-posh 꾸미면서 scoop으로 git 설치했던게 기억나서 한번 해봤더니 됐다.

1. Window Terminal 실행 (이건 부팅 완료하자마자 Microsoft App에서 다운로드해둠)

2. Window Powershell 설치(재설치 되거나 업데이트됨)

# powershell install
winget search Microsoft.PowerShell
winget install --id Microsoft.Powershell --source winget

3. 한영 키보드(영어)로 하고, Scoop 설치

# scoop
$ Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # Optional: Needed to run a remote script the first time
$ irm get.scoop.sh | iex

4. Scoop으로 git 설치

$ scoop install git

5. Clone할 경로로 이동해서 git clone ....

[windows] Terminal (cmd, powershell) 꾸미기

Mary's log — Mon, 20 Jan 2025 18:50:28 +0900

참고 문헌

Window 10 (정리하긴 했는데 그냥 아래 블로그에서 적당히 따라했다)
Windows에서 Oh My Posh 즐기기

Window 11
1. PowerShell 꾸미기 < 따라하다가 오류 발생...
2. 못생긴 windows Powershell 예쁘고 쓸만하게 만들기 < 위에서 설치한 내용 바탕으로 추가
3. 경고 뜨고, 아이콘 안 뜨는 오류는 chatgpt 도움으로 결국 꾸미기 성공

환경 : 오래 전에 Window 10 Pro 로 구매했으나 2024-12-25에 무료로 11 업그레이드,

진행 도중에 내 pc Windows 11 Pro은 이미 powershell 버전은 7이었다. (5가 아니고..?)

이미 꾸미기 완료 하고 기억 나는대로 적은거라 완벽하지 않을 수 있다;

++ 2025-02-02 pc를 Win 10으로 재설치하면서 또 다르게 에러가 난다. Win 10은 참고 블로그를 눈치껏 따라하는게 좋을듯 싶다.

mac에서 iTerm, oh-my-zsh, powerlevel10k로 커스텀해서 살다가

오랜만에 windows로 넘어와서 싹 포맷 후 11 버전으로 업글하고 cmd, powershell을 열었더니... 삭막해졌다...

미감이 죽은 채로 덜 예민하게 살아도 무방한 감각이었으면 좋았으련만...

아무튼

참고문헌의 1 블로그를 따라서 여러개 설치했다.

(맥의 brew에 익숙해지고, 윈도우의 커맨드가 뭔지 잘 몰라서 헤맸지만 40분 만에 꾸미기는 완료한거 같다)

Nerd Fonts 사이트에서 사용할 폰트 설치

https://www.nerdfonts.com/font-downloads

위의 사이트 들어가서, 나는

FiraCode Nerd Font, FiraMono Nerd Font를 설치했다.

예전에 이런 특정 테마?에 써야하는 폰트를 설치해야하는 걸 몰랐을 적에는

eclipse, sts, notepad++ 에서 주로 'D2Coding'를 사용했었는데

각자 OS theme에 맞는 아이콘까지 정상 조회되려면

해당 테마에 맞는 font로 지정해야하더군요, 아무튼

Windows Terminal 설치

~~난 이미 Windows 10 에서~~ ~~11 로 버전 Up 되고 나니 기본으로 설치되어 있길래 잘 모르겠다.~~

Window 11 에서는 Terminal이 자동으로 설치되어 있었는데

Window 10 으로 다운그레이드 하니까 없다... 그렇군요 설치한다.

Microsoft Store - Terminal - 소유함(설치GO) - 끝.

Windows Terminal 시작 설정, 폰트 설정

Terminal이 prompt로 시작시킬지, powershell로 시작시킬지 설정하고

폰트도 설정해줄 것이다.

작업 표시줄 - 검색 - 터미널 >

'설정' 열기.

Terminal을 열거나 + 탭을 누르면 'Windows PowerShell'로 시작하게 설정.

이제 PowerShell 인 경우 폰트를 바꾸러 간다. (다른 shell 도 폰트 변경해둬도 좋을듯)

Windows PowerShell - 추가 설정 - 모양

아까 설치했던 Fira 머시기 각자의 폰트로 '글꼴'에 변경

Scoop, Neovim, gcc 설치

scoop은 mac의 brew 같은거려나. 아무튼 저거 다 설치 안되어있어서 했다.

Scoop

아래에서 첫번째 cmd를 치면 Y / N 뭐시기 할거냐 물어보는데 Always Y (항상 네) 였던가를 해야했던 거 같다...

잘 몰라서 의심스럽길래 그냥 Y 했더니 나중에 명령어가 잘 안 먹혀서 또 물어봤던 것 같다.

# scoop
$ Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # Optional: Needed to run a remote script the first time
$ irm get.scoop.sh | iex

Neovim

vi, nano 그런 명령어인가 아무튼 설치하라니까 일단 설치

gcc

c언어 compiler라고 한다.

$ scoop install neovim gcc

여기까지 설치했으면 한 번 컴퓨터를 재부팅한다. 다시시작, 껐다 켜기.

⭐ ⭐ ⭐ 진행하다 오류 내용 ⭐ ⭐ ⭐

1. user_profile.ps1 파일에 Set-Alias 입력 후 저장하면? 저장이 안됐다.

2. scoop으로 Oh My Posh git 설치가 안된다.

테마를 안 정해놔서 일단 뭐라도 됐으면 좋겠는데 다 오류가 나서 다른 블로그를 찾았다.

두번째 블로그에서는

powershell 기본이 5라길래 7을 설치하래서 일단 설치했다.

(근데 이미 내 pc powershell은 버전 7.4. 뭐시기였던거 같은데 또 해도 무방하니까 그냥 따라가기)

# powershell install
winget search Microsoft.PowerShell
winget install --id Microsoft.Powershell --source winget

Window 10에서 새로 설치해서 그런가, Win 11 때와는 다른 느낌이다.

일단 하단의 추천 bucket들 설치 명령어를 수행하면 설치가 안된다고 오류가 뜬다.

밑의 git을 먼저 설치하라고 친절한 설명이 뜨니, git을 먼저 설치한다.

$ scoop install git

그 후에 bucket 설치 명령어가 잘 수행된다.

$ scoop bucket add extras 
$ scoop bucket add java
$ scoop bucket add nerd-fonts
$ scoop install aria2 

# 본인이 설치한 폰트명?
$ scoop install which fzf jq zoxide fd nerd-fonts bat FiraMono-NF
# 아무튼 이건 오류 발생. [Couldn't find manifest for 'nerd-fonts'.]

# 안써봤는데 좋아보여서 넣어봄? (뭔지 모르겟지만 일단 참고 블로그 따라함;)
$ scoop install sudo curl grep gzip tar touch vim neovim 7zip powertoys bottom ntop
$ scoop install coretemp cpu-z crystaldiskinfo aria2 crystaldiskmark filezilla honeyview hwmonitor hxd postman putty unlocker vscode python everything openjdk17 python nvm mysql yarn docker
$ scoop install kubectx k9s

중간에 안되던 것도 있던거 같은데 몰러 걍.. 필수는 아닌듯 하여;

zoxide 설치

path를 저장해 주는 도구. Win 10에서 진행하다 안돼서 확인해보니 이 부분이 없다고 한다.

설치하자마자 뭔가 폰트가 바뀌면서 적용되는 듯? (아닐수도)

scoop install zoxide 
Invoke-Expression (& { (zoxide init powershell | Out-String) })

또 oh-my-posh 설치 오류?

아래 3개 중 첫 번째는, Terminal에서 진행하면 아래와 같은 권한 요구 문구가 뜨기 때문에,

Install-Module Terminal-Icons -Repository PSGallery -Force
Install-Module posh-git -Scope CurrentUser -Force
Install-Module oh-my-posh -Scope CurrentUser -Force

Install-Module : 'C:\Program Files\WindowsPowerShell\Modules'에 모듈을 설치하려면 관리자 권한이 필요합니다. 관리자 권한
이 있는 계정으로 컴퓨터에 로그온한 후 다시 시도하거나 "-Scope CurrentUser"를 명령에 추가하여 'C:\Users\parks\Documents\
WindowsPowerShell\Modules'을(를) 설치하십시오. 관리자 권한(관리자 권한으로 실행)으로 Windows PowerShell 세션을 실행해
볼 수도 있습니다.
위치 줄:1 문자:1
+ Install-Module Terminal-Icons -Repository PSGallery -Force
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Install-Module], ArgumentException
    + FullyQualifiedErrorId : InstallModuleNeedsCurrentUserScopeParameterForNonAdminUser,Install-Module

PowerShell (터미널 아님!)을 '관리자 권한으로 열기'로 진행해서

NuGet 공급자에 대한 동의 Y를 입력하고, Install-Module 3개를 다시 진행한다.

위에서 oh-my-posh를 설치했음에도 불구하고 아래 2개 CLI를 실행하면

oh-my-posh init pwsh --config 'https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/atomic.omp.json' | Invoke-Expression
scoop install https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/oh-my-posh.json

다음과 같은 오류가 뜬다. 흠...

$ oh-my-posh init pwsh --config 'https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/atomic.omp.json' | Invoke-Expression
>>
oh-my-posh : 'oh-my-posh' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.
이름이 정확한지 확인하고 경로가 포함된 경우 경로가 올바른지 검증한 다음 다시 시도하십시오.
위치 줄:1 문자:1
+ oh-my-posh init pwsh --config 'https://raw.githubusercontent.com/JanD ...
+ ~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (oh-my-posh:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException



$ scoop install https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/oh-my-posh.json
WARN  error: 원격 서버에서 (404) 찾을 수 없음 오류를 반환했습니다.
Couldn't find manifest for 'oh-my-posh' at 'https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/oh-my-posh.json'.

+ Window 10 에선 계속 위의 오류가 떠서 검색 ( 참고 블로그 ) 해서

$ Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

위의 명령어 실행 후,

실행 규칙 변경
실행 정책은 신뢰하지 않는 스크립트로부터 사용자를 보호합니다. 실행 정책을 변경하면 about_Execution_Policies 도움말
항목(https://go.microsoft.com/fwlink/?LinkID=135170)에 설명된 보안 위험에 노출될 수 있습니다. 실행 정책을
변경하시겠습니까?
[Y] 예(Y)  [A] 모두 예(A)  [N] 아니요(N)  [L] 모두 아니요(L)  [S] 일시 중단(S)  [?] 도움말 (기본값은 "N"): A

실행 규칙은 N에서 A로 변경했다... (근데 이거 위에서 ' Set-ExecutionPolicy RemoteSigned -Scope CurrentUser' 이거로 했는데도 왜 또..?)

++ Win 11에선 어찌저찌 됐는데 Win 10에선 oh-my-posh가 계속 설치가 안되는 오류로 인해서

또 검색해서(참고블로그)... 추가 설치 명령어를 실행했다.

$ winget install JanDeDobbeleer.OhMyPosh -s winget

그리고 아래 나와있는 profile.ps1 파일 부분에서

# oh-my-posh 초기화
oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH\easy-term.omp.json" | Invoke-Expression

여기를 Win 10일 땐,

# oh-my-posh 초기화
oh-my-posh init pwsh | Invoke-Expression

이렇게 바꾸니까 먹혔다.. 사실 커맨드 하나하나 분석해서 해야하지만, 귀찮아서 막했더니 일어난 참사;

(처음에 이렇게 했다가 나중에 밑에 가서 Theme 다시 config 해주니 먹혔다)

아무튼

Win 10에서 어찌저찌 성공해서 Terminal을 열면 이렇게

Win 11에선 Terminal을 열면 이렇게 뜨긴 한다...

이 때 Font 설정 안 바꿔놔서 아이콘이 다 깨지고 있다. Font만 바꿔주면 된다.

(Win 11일 땐) Terminal을 열 때마다 빨간색 글씨로

아래와 같은 경고들이 뜨기 시작했다.

경고: PSReadLine ?듭뀡? PowerShell 7 ?댁긽?먯꽌留?吏?먮맗?덈떎.

Set-PSReadLineOption : 매개 변수 이름 'PredictionSource'과(와) 일치하는 매개 변수를 찾을 수 없습니다.
위치 C:\Users\user\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1:12 문자:22
+ Set-PSReadLineOption -PredictionSource History
+                      ~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Set-PSReadLineOption], ParameterBindingException
    + FullyQualifiedErrorId : NamedParameterNotFound,Microsoft.PowerShell.SetPSReadLineOption

Set-PSReadLineOption : 매개 변수 이름 'PredictionViewStyle'과(와) 일치하는 매개 변수를 찾을 수 없습니다.
위치 C:\Users\user\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1:13 문자:22
+ Set-PSReadLineOption -PredictionViewStyle ListView
+                      ~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Set-PSReadLineOption], ParameterBindingException
    + FullyQualifiedErrorId : NamedParameterNotFound,Microsoft.PowerShell.SetPSReadLineOption

Set-Alias : 'history' 별칭에서 AllScope 옵션을 제거할 수 없습니다.
위치 C:\Users\user\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1:18 문자:1
+ Set-Alias history historyfunc
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : WriteError: (history:String) [Set-Alias], SessionStateUnauthorizedAccessException
    + FullyQualifiedErrorId : AliasAllScopeOptionCannotBeRemoved,Microsoft.PowerShell.Commands.SetAliasCommand

bash 설정

$ notepad $profile

로 설정을 바꾸고 반영하는

$PROFILE

를 실행했음에도

인코딩 깨짐 + 못찾겠단 경고가 계속 떴다. chatgpt가 도와준 최종 bash 설정은 이러하다.

⭐주의 : 나는 기존에 설정값들이 있어서 그 내용을 바탕으로 chatgpt가 수정해준 것이기 때문에,

다른 오류가 발생할 수 있으니 각자 환경에 맞게 수정해야한다.

# oh-my-posh 초기화 테마 설정. 바로 config Theme 지정이 안된다면 이거로 먼저 실행?
oh-my-posh init pwsh | Invoke-Expression

# oh-my-posh 초기화 및 테마 지정 (Theme : https://ohmyposh.dev/docs/themes)
oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH\easy-term.omp.json" | Invoke-Expression
oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH/M365Princess.omp.json" | Invoke-Expression

# Terminal-Icons 모듈 불러오기
Import-Module -Name Terminal-Icons

# zoxide 초기화
Invoke-Expression (& { (zoxide init powershell | Out-String) })

# 별칭 설정
Set-Alias vim nvim
Set-Alias ll ls
Set-Alias grep findstr
Set-Alias k kubectl

# PSReadLine 키 설정
Set-PSReadLineOption -EditMode Emacs
Set-PSReadLineOption -BellStyle None
Set-PSReadLineKeyHandler -Chord 'Ctrl+d' -Function DeleteChar

# PowerShell 7 이상에서만 PSReadLine 설정 적용
if ($PSVersionTable.PSVersion.Major -ge 7) {
    try {
        Set-PSReadLineOption -PredictionSource History
        Set-PSReadLineOption -PredictionViewStyle ListView
    } catch {
        # 오류 발생 시 메시지 출력 안 함
    }
}

# history 함수 정의 및 별칭 설정
function historyfunc {
    type $env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine\ConsoleHost_history.txt
}
Remove-Item Alias:history -Force  # 기본 history 별칭 제거
Set-Alias history historyfunc     # history 별칭으로 새로 설정

기존에 뜨던 빨간 경고들과 + 아이콘이 안 뜨던 것들 등 해결이 되었고

최종적으로는 아래와 같이 잘 뜨고 있다.

순서랑 설정값은 모르겠지만 사실 노트북 포맷을 잘하는지라 나중에 까먹을 나를 위하여... 기록해둔다.

[mac/Docker] 'com.docker.socket'에 / 'com.docker.vmnetd'에 악성 코드가 포함되어 있어서 열리지 않았습니다.

Mary's log — Fri, 10 Jan 2025 05:57:26 +0900

할 일을 마치고 맥북을 닫고 자려던 순간 갑자기 이런게 떴다. (자게해줘)

악성 코드가 차단됨

'com.docker.socket'에 악성 코드가 포함되어 있어서 열리지 않았습니다. 이 동작은 Mac을 손상시키지 않았습니다.

악성 코드가 차단됨

'com.docker.vmnetd'에 악성 코드가 포함되어 있어서 열리지 않았습니다. 이 동작은 Mac을 손상시키지 않았습니다.

구글링 go

https://github.com/docker/for-mac/issues/7520

[Workaround in description] Mac is detecting Docker as a malware and keeping it from starting · Issue #7520 · docker/for-mac

Description Whenever Docker is started, this error is shown: Malware Blocked. “com.docker.socket” was not opened because it contains malware. this action did not harm your Mac. Reproduce Start Dock...

github.com

다른 사람들 이슈는 'Docker를 시작하면'이라고 올라왔지만

난 도커가 설치되어 있었지만 이 맥북에선 1달 넘게 미사용 중임에도 뜬거였다.

그래서 그냥 도커 문제인갑다- 하고

처음엔 도커 앱도 삭제하고, 인터넷 검색해서 '도커 완전 삭제'으로 관련 폴더 별로 파일도 전부 삭제했는데도 계속 떴다.

초반엔 '시스템 종료' 후 처음 맥북 켰을 때만 뜨더니,,, 점차 5초마다 뜬 거 같다.

아래 순서대로 커맨드 치지도 못할 정도로 떴다.

나 같은 경우는, 위 링크에서 제시하는 명령어를 추가로 수행했더니 더이상 뜨지 않았다.

해결 순서

1. Quit Docker Desktop and check that no remaining docker processes are running using the Activity Monitor

도커 데스크탑을 종료하고 '활동 모니터'를 사용하여 남은 도커 프로세스가 실행되지 않는지 확인합니다.

2. command 실행

#!/bin/bash

# Stop the docker services
echo "Stopping Docker..."
sudo pkill '[dD]ocker'

# Stop the vmnetd service
echo "Stopping com.docker.vmnetd service..."
sudo launchctl bootout system /Library/LaunchDaemons/com.docker.vmnetd.plist

# Stop the socket service
echo "Stopping com.docker.socket service..."
sudo launchctl bootout system /Library/LaunchDaemons/com.docker.socket.plist

# Remove vmnetd binary
echo "Removing com.docker.vmnetd binary..."
sudo rm -f /Library/PrivilegedHelperTools/com.docker.vmnetd

# Remove socket binary
echo "Removing com.docker.socket binary..."
sudo rm -f /Library/PrivilegedHelperTools/com.docker.socket

# Install new binaries
echo "Install new binaries..."
sudo cp /Applications/Docker.app/Contents/Library/LaunchServices/com.docker.vmnetd /Library/PrivilegedHelperTools/
sudo cp /Applications/Docker.app/Contents/MacOS/com.docker.socket /Library/PrivilegedHelperTools/

3. Restart Docker Desktop.

다시 도커 데스크탑 실행.

* 나는 이미 앱도 삭제했었어서 가장 최신 버전으로 다시 다운로드해서 실행했다. (이슈 내용에도 최신 버전으로 받으라고 적혀있다.)

처음엔 실행이 안되고 팅기면서 팝업이 다시 떴는데, 다시 위 커맨드 하고 나니 더이상 안 떴다.

마지막 '시스템 종료'했다가 다시 열어도 팝업 안 뜨는거 확인!

[mac] jekyll Chirpy 테마로 GitHub Pages 만들기

Mary's log — Wed, 8 Jan 2025 02:43:49 +0900

환경 : MacBook Pro 14 M3 macOS 15.1.1
세팅 : 이미 brew, iTerm 설치 세팅 완료된 상태. (여기까진 알아서..)
주의 : 기술 내용은 [포스팅 시점, PC환경]에 따라서 동작하지 않을 수 있음.
'[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.

테마 : Chirpy

제작자 공식 GitHub : [Official] cotes2020 (Cotes Chung)

제작자 공식 안내 가이드 : [Official] Getting Started | Chirpy

제작자 Repository 'jekyll-theme-chirpy' < Fork

제작자 Repository 'chirpy-starter' < Use this template

참고 문헌

Jekyll Chirpy(v6.0.1) 테마를 활용한 Github 블로그 만들기(2023.6 기준) < Actions - build에서 오류 발생

Jekyll Chirpy 테마 사용하여 블로그 만들기 < 됐다!!! (생각보다 훨씬 간단하고 빠르게 끝나서 허탈..)

이미 username.github.io 로 만든 Repository가 있다면, 이름을 임시로 다른거로 바꾼다.

안그러면 지금 Fork로 만들 Repository 이름을 나중에 username.github.io 로 사용 못한다.

(앞에서 chripy-starter로 성공하고 나서 적은거라, 이해가 안되거나 부가설명은 앞의 글을 읽는 걸 추천합니다.)

제작자 Repository 'jekyll-theme-chirpy' 에서 Fork를 진행한다.

Fork로 진행 시, Repository 이름을 다른 거로 하고 그 뒤에 Settings에서 Rename해야만

Actions에서 'pages build and deployment'를 확인할 수 있다. (처음부터 적었더니 안 나타나더라..)

나는 탐색기/Finder에 'jekyll' 이라는 폴더를 하나 만들고 그 안에 프로젝트를 clone했다.

('[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.)

clone하고 나서 해당 경로로 이동한다. 아래 명령어로 chirpy를 초기화한다

프로젝트 내부 경로 > tools/init.sh

init.sh 파일이 동작하면서 필요없는 파일은 삭제해주는 듯하다.

# Fork 프로젝트에 있는 '의존성이 있는 모듈을 모두 설치'
$ bundle

# 로컬에서 jekyll server 가동
$ jekyll serve

크롬 브라우저 localhost:4000 으로 이동해서 확인한다.

추가수정삭제한 파일들을 GitHub 에 commit, push 하기 전에! linux platform을 추가하자.(mac인 경우)

linux platform을 꼭 추가한 후!!! > (추가수정삭제된 파일들을) GitHub Desktop으로 commit push해야만

GitHub Actions의 build deploy 에서 오류가 안난다.

$ bundle lock --add-platform x86_64-linux

이제 파일 추가, 수정하러 가보자.

추가수정삭제는 메모장, 편집기, 뭐로 수정하든 상관없다. 어차피 상태에 따른 '형상 관리'가 중요한 거라.

나는 Visual Studio Code로 clone한 Folder를 열었다.

1. 가장 중요한 url 수정

위에 복사해서 밑에 그대로 넣고 username만 수정하면 된다.

url: "https://<username>.github.io"

2. timezone Asia/Seoul 수정

주석의 링크에 들어가면 현재 위치한 지역의 timezone에 대해서 나오는걸 복사해서 넣으면 된다.

3. 테스트용 md 파일 추가

_posts 하위에 새로 파일을 만든다. 파일명은 컨벤션(규칙)에 맞춰서 작성해야 나중에 브라우저에서 보인다.

컨벤션 관련해서는 제작자 안내가이드나 설명 잘한 글들이 많으니 찾아보면 된다.

나는 '2025-01-01-테스트.md' 라고 파일명을 짓고, 다음 파일 소스를 작성했다.

---
title: 테스트
date: 2025-01-07 02:00:00 +09:00
categories: [상위 카테고리, 서브 카테고리]
tags: [test] # TAG names should always be lowercase
---

테스트 내용

GitHub Desktop으로 commit, push하기 전에

수정한 내용이 제대로 반영됐는지, 로컬에서 jekyll server를 돌려서 확인해보자.

언어, 수정 내용이 로컬에서 잘 보이는 걸 확인.

이제 GitHub Desktop을 연다.

('[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.)

Add an Exisiting Repository from your Local... 를 선택하고

Choose...를 선택한다.

clone한 프로젝트를 열고, Add Repository 한다.

이제 clone한 경로의 파일들이 추가수정삭제된 걸 commit,push할 수 있는 준비 끝.

starter 때와 다른 설정이 있다.

1. 뭔가 Pull 받아야하는 이력이 있다.

2. commit message에 컨벤션을 지켜서 작성해야한다.

1은 나중에 자동 진행될거라서 일단 pass.

2를 보자. commit message에 그냥 first commit 이라고 작성하고 commit하면

이런 Error가 뜬다.

⧗   input: first commit
✖   subject may not be empty [subject-empty]
✖   type may not be empty [type-empty]

✖   found 2 problems, 0 warnings
ⓘ   Get help: https://github.com/conventional-changelog/commitlint/#what-is-commitlint

husky - commit-msg script failed (code 1)

⧗ 너의 입력은 : first commit이네

✖ (니 입력에)주제 없다 [주제-비어있음]
✖ (니 입력에)타입 없다 [타입-비어있음]
✖ found 2 problems, 0 warnings
ⓘ Get help: commitlint 깃헙 가서 컨벤션 변경 로그 봐.
husky (가 알려줌) - 커밋 메시지 스크립트가 실패했다.

대충 이런 의미라서 File에 문제가 생긴 건 아니다. 개인적으로 관리할거면 이 설정을 해제하는 방법도 있지만

웬만해선 커밋 메시지 컨벤션 지키는게 좋기도 하고,

참고 문헌 : 커밋 메세지 작성 가이드라인 - Conventional Commits

일단 Fork한 거로 GitHub Pages 정상 동작하는 거 먼저 보고, 해제하는 건 나중에 하자.

아무튼 작성법만 지키면 된단 얘기 아닌가! Get help로 가서 commit message 작성법이 뭔지 본다.

Error가 subject, type 없다고 했는데 저렇게 쓰면 되나 보구나..

type은 저기 있는 단어 목록 중에 상황에 골라 쓰고 : 뒤에 쓰고 싶은 커밋 메시지를 쓰면 된다.

feat(blog): first commit < 이거로 작성해본다.

넘어갔다. 좌측 하단에 방금 커밋되었다는 걸 볼 수 있다.

이제 1. Pull 받아야한다. (받아야만 방금의 commit과 함께 push 가능)

원래는 이런 저런 이유로 Pull 이 안되는 상황도 있지만,

지금은 되니까 Pull origin 진행하고 Push origin 까지 진행한다.

Pulling origin...

Pushing to origin...

이제 빨리 본인의 Repository - github.io로 가보자.

빨간 부분은 가장 마지막 최신 commit push의 commit message를 보여주고

그 옆은 갈색 원은 build & deploy의 상태를 보여주는 부분이다. 완료되면 초록 체크로 바뀐다.

starter 스샷 가져온거라 다른 부분은 pass

또 빠르게 Actions 탭으로 이동한다.

pages build and deployment, feat (blog): first commit

맨 처음에 있었던 workflow와 동일한 이름과 방금 적었던 commit message까지 2개 갈색 원이 떠있다.

초록 체크로 완료되면 빌드 배포가 성공한 것이다.

가장 마지막에 성공한 workflow 선택해서 들어가고 deploy 밑의 링크 ( = GitHub Pages 링크)를 누른다.

이제 starter가 아닌, Chirpy 로 GitHub Pages 를 작성할 수 있게 됨!

의아한 게, 참고 문헌 Jekyll Chirpy 테마 사용하여 블로그 만들기

이 글은 과거 글인데도 나는 'Settings - GitHub Actions'로 바꾸지 않고도 일단 동작했다. (댓글은 혼란의 장이고 나역시도)

프로젝트 내부의 .github/workflows/pages-deploy.yml 가 있어서 GitHub Actions로 바꾸지 않고도

GitHub Actions에서 'pages build and deployment' workflow로 빌드 배포가 되는건가 싶다.(아닐수도)

계속 md 글 작성, css 수정하면서 오류가 나는지 확인해봐야겠지만, 여기까지는 GitHub Actions로 바꾸지 않고

GitHub Pages를 Chirpy로 만들기 성공!!!

[mac] jekyll Chirpy-starter 로 GitHub Pages 만들기2

Mary's log — Wed, 8 Jan 2025 01:24:02 +0900

환경 : MacBook Pro 14 M3 macOS 15.1.1
세팅 : 이미 brew, iTerm 설치 세팅 완료된 상태. (여기까진 알아서..)
주의 : 기술 내용은 [포스팅 시점, PC환경]에 따라서 동작하지 않을 수 있음.
'[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.

테마 : Chirpy

제작자 공식 GitHub : [Official] cotes2020 (Cotes Chung)

제작자 공식 안내 가이드 : [Official] Getting Started | Chirpy

제작자 Repository 'jekyll-theme-chirpy' < Fork

제작자 Repository 'chirpy-starter' < Use this template

본인 GitHub Repository의 Actions Tab으로 간다.

나는 Repository 생성 시 이름을 바로 username으로 했더니, 이미 build deploy 이력이 있다.

Settings - Pages - Build and deployment에서 GitHub Actions로 바꾼다.

Default로 정해둔 branch에 push 하면

GitHub이 변동을 감지하고 ✌️웬만해선✌️ 자동으로 알아서 build & deploy 해준다.

(원랜 workflow file에 build & deploy 되게하는 설정 넣고 한땀한땀... )

참고 문헌

Github 페이지 Chirpy 테마 적용 방법 (ver. 2023)

처음에 chirpy-starter가 아닌 jekyll-theme-chirpy로 했을 때 여러 시행착오가 있었는데

GitHub Actions로 바꿔도, _config.yml을 수정해도, GitHub Desktop으로 commit해도

'—layout: home # Index page —' 가 뜬다는 거였다.

내 쪽에서의 문제는 'OS platform 상이'...

iTerm을 연다.

clone한 경로로 이동해서 Gemfile이 있는 곳에서!

아래 bundle 명령어로 Linux platform을 추가한다.

  $ bundle lock --add-platform x86_64-linux

linux platform을 꼭 추가한 후!!! > (추가수정삭제된 파일들을) GitHub Desktop으로 commit push해야만

GitHub Actions의 build deploy 에서 오류가 안난다.

이제 파일 추가, 수정하러 가보자.

추가수정삭제는 메모장, 편집기, 뭐로 수정하든 상관없다. 어차피 상태에 따른 '형상 관리'가 중요한 거라.

나는 Visual Studio Code로 clone한 Folder를 열었다.

1. 가장 중요한 url 수정

위에 복사해서 밑에 그대로 넣고 username만 수정하면 된다.

url: "https://<username>.github.io"

2. timezone Asia/Seoul 수정

주석의 링크에 들어가면 현재 위치한 지역의 timezone에 대해서 나오는걸 복사해서 넣으면 된다.

3. locales/ko-KR 언어 반영 (starter 기준)

starter 프로젝트는 기본 기능만 있어서 다국어 파일이 없다. 풀 버전 프로젝트에서 가져오자.

제작자 jekyll-theme-chirpy의 _data/locales/ko-KR.yml 경로 < 여기로 바로 이동해서 ko-KR.yml 파일만 다운로드 받는다.

내 mac에 clone한 프로젝트에서 _data 경로 하위에 'locales' 폴더를 새로 만들고 그 하위에 다운로드한 ko-KR.yml 파일을 넣고

_config.yml의 lang에 파일명 ko-KR을 넣는다. (다른 언어도 이런식으로 설정하면 된다.)

그 외 _config.yml에서 필수 고정 내용 말고

사용자 입장에서 수정하고 싶은게 있다면 수정한다.

GitHub Desktop으로 commit, push하기 전에

수정한 내용이 제대로 반영됐는지, 로컬에서 jekyll server를 돌려서 확인해보자. (방법은 1에 있음)

언어, 수정 내용이 로컬에서 잘 보이는 걸 확인.

이제 GitHub Desktop으로 commit, push하러간다.

('[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.)

commit은 변경이력을 콕콕 찍어서 남기는 거라 보면 되고, (commit 했다고 GitHub Repository에 최종 반영X)

push는 그 commit 이력들을 push 밀어넣는다고 보면 된다. 일반인이 볼 때 이정도만..

GitHub Desktop 실행.

파일 별로 추가수정삭제한 내용에 문제가 없는지 확인하고

어떤 것이 바뀌었는지 commit message 에 작성하고, 'Commit to main' 버튼을 누르면 commit이 된거다.

commit 했다고 GitHub Repository에 변경 내용이 반영되는게 아니다.

Push origin까지 누른다.

이제 빨리 본인의 Repository - github.io로 가보자.

빨간 부분은 가장 마지막 최신 commit push의 commit message를 보여주고

그 옆은 갈색 원은 build & deploy의 상태를 보여주는 부분이다. 완료되면 초록 체크로 바뀐다.

또 빠르게 Actions 탭으로 이동한다.

commit message에 적힌 무언가 run 하고 있다. 눌러서 들어간다.

선택한 Build and Deploy 내용을 볼 수 있다.

10초만에 build가 끝나고 deploy를 하고 있는거다. deploy까지 초록체크로 완료되면 이제 GitHub Pages를 확인한다.

크롬 브라우저에

https://<username>.github.io 로 이동하면, 아까 로컬에서 보이던 화면과 동일하게 보인다.(동일해야함!!!)

시크릿 모드에서 해도 잘 열린다.

이제 카테고리에 글 추가하는 건 .md(markdown) 파일 작성하고, 넣을 위치 찾아서 넣으면 된다.

저 화면에서 바로바로 '글 작성', '글 수정', '글 삭제' 이런 기능이 있는게 아니다!!!

직접 파일을 추가하고 수정해서 commit, push해야하는 것이다.

일반인 입장에선 번거롭게 느껴질 수도 있지만 가장 중요포인트는

✌️서버비 돈 안내고 공짜✌️ 인거다. 물론 GitHub Pages말고 사용자 입장에서의 서버리스 서비스는 많다.

(Vercel, Netlify 등 조건은 다르지만 아무튼)

- Vercel, Netlify -

프론트하는 친구한테 듣기만 하고 해보고 싶다했지만 다른 공부할 게 많아서 눈여겨만 봄

markdown 작성해서 올리는 건 다음 글에...

[mac] jekyll Chirpy-starter 로 GitHub Pages 만들기1

Mary's log — Tue, 7 Jan 2025 23:56:10 +0900

환경 : MacBook Pro 14 M3 macOS 15.1.1
세팅 : 이미 brew, iTerm 설치 세팅 완료된 상태. (여기까진 알아서..)
주의 : 기술 내용은 [포스팅 시점, PC환경]에 따라서 동작하지 않을 수 있음.
'[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.

테마 : Chirpy

제작자 공식 GitHub : [Official] cotes2020 (Cotes Chung)

제작자 공식 안내 가이드 : [Official] Getting Started | Chirpy

제작자 Repository 'jekyll-theme-chirpy' < Fork

제작자 Repository 'chirpy-starter' < Use this template

GitHub Pages Themes는 검색해보면 정보 글들이 많다.

그 중에 Chirpy가 마음에 들어서 골랐는데 원래 인기가 많은 테마라고 한다.

제작자의 GitHub Repository에는 여러 프로젝트가 있다.

1. jekyll-theme-chirpy

웬만한 설정이 들어가있는 프로젝트. 자세한 차이점은 다른 글들 찾아보면 상세히 작성해줘서 따로 찾아보진 않았다.

맨 처음에 이거로 Fork했다가 안돼서 2. starter로 시도해봤더니 됐다.

(좀 더 시도해본 결과, 결국 이 프로젝트로도 성공했다. 글 추가 작성중...)

2. chirpy-starter

기본 기능만 들어있는 프로젝트.

ag. 한국어 지원 파일이 없어서 따로 넣어줘야함.

제작자 안내가이드에도 'Option 1. Using the Starter (Recommended)' 라고 적혀 있길래

일단 2. chirpy-starter로 성공한 흐름을 적었다.

참고 문헌

제작자 공식 안내 가이드 : [Official] Getting Started | Chirpy

일단 제작자 안내대로 [제작자 stater -> 내 깃헙에서 만들기] 진행한다.

Settings 가서 이름 바꾸기 귀찮아서 그냥 바로 username.github.io 로 만들었다.

만들어지면, https 복사한다.

나는 탐색기/Finder에 'jekyll' 이라는 폴더를 하나 만들고 그 안에 프로젝트를 clone했다.

('[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.)

* 명령어 실행하다 'Could not locate Gemfile' 오류가 뜬다면,

jekyll 서버로 돌리려면 프로젝트의 Gemfile이 있는 곳에서 돌려야하는 것이다.

1. clone한 프로젝트에 Gemfile이 있는지 확인하고 터미널에서 파일 경로까지 이동한다.

2. 다시 명령어를 실행해본다.

아래가

제작자가 오픈소스로 공유해준 Chirpy starter 프로젝트를 내 Repository로 가져와서

아직 나의 GitHub 주소나, 다른 수정사항이 1도 없는

로컬에서 jekyll 서버로 보이는 상태이다.

GitHub Pages를 쓴다는 건

내 로컬이 켜져있을 때만 서버를 돌리는게 아니라, 이미 GitHub이 마련해준 정적 사이트 서비스를 무료로 쓰는거다.

위는 Chirpy가 제대로 보이는지 여부를 위한 테스트를 로컬에서 jekyll 서버로 돌리기만 한거고,

이제 Chirpy가 GitHub에서 서버가 돌아가야 하는 것.

중요한 건, 컴퓨터는 Operating System. OS가 다를 수 있다.

안드로이드 폰, 아이폰 폰은 눈에 보이는 디자인이나 기능 동작들에 있어서 필수 기능,부품들은 일반인 분엔 같아보일지라도

분명 제작사는 다른거다.

OS도 Windows, macOS, Linux 등이 있고 다들 태어나고 만들어진 플랫폼 platform이 달라서
그래서 GitHub Pages에 build & deploy할 때

"너 지금 빌드 배포하고 있는 OS 플랫폼이 이거 아닌 거 같아. 혹시 다른거면 설정 파일 속에 어떤 설정값 있어야만 인식하는데

그게 없어서 빌드 배포 오류나.." 라면서 안될 수 있다.

그래서 macOS에서 파일(_config.yml이든 md 파일을 추가수정삭제 하든)을 수정하고 배포빌드하기 전에

아래 명령어로 추가하고 commit push해야한다.

$ bundle lock --add-platform x86_64-linux

하기 전에 GitHub에 파일을 추가수정삭제하고 commit, push 하기 위한(형상관리) 준비를 하고 간다.

(termianl 명령어, fork로도 해봤는데 안되고, GitHub Desktop으로만 해야지 GitHub에 반영되는 것을 확인)

GitHub Desktop을 연다.

('[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.)

Add an Exisiting Repository from your Local... 를 선택하고

Choose...를 선택한다.

clone한 프로젝트를 열고, Add Repository 한다.

이제 clone한 경로의 파일들이 추가수정삭제된 걸 commit,push할 수 있는 준비 끝.

(아직 _config.yml이나 뭐 수정해서 commit하면 안된다!!!)

다음 글에서 GitHub Pages에 GitHub Actions로 빌드 배포하기 위한 걸 확인 후 진행한다.

[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅

Mary's log — Tue, 7 Jan 2025 23:26:11 +0900

환경 : MacBook Pro 14 M3 macOS 15.1.1
세팅 : 이미 brew, iTerm 설치 세팅 완료된 상태. (여기까진 알아서..)
주의 : 기술 내용은 [포스팅 시점, PC환경]에 따라서 동작하지 않을 수 있음.

일단 Why jekyll을 설치하나?

jekyll 설치 후 로컬에서 jekyll로 서버를 돌리고, 로컬에서 원하는 GitHub Page 테마가 제대로 보이는지 확인해야하기 때문.

jekyll 공식 홈페이지

우측 하단의 Quik-start Instructions 가 오류 없이 동작되어야 한다.

그러기 위해선 명령어 gem, jekyll, bundle 설치해야 한다.

위 명령어들은 rbenv, ruby가 설치되어있어야한다. ~~뭐를 설치하기 위해서 뭐를 설치하는 행진~~

작성 시점 기준, 로컬 mac의 rbenv, ruby 버전이 3.1.0 이상이어야한다해서,

rbenv, ruby 버전 맞추기를 진행한다. (mac 기준, Win은 모르겠음)

iTerm 열기

# Ruby 버전 확인 (둘이 같아야함. 다르다면 환경변수 잡아줘야함)
$ rbenv versions
$ ruby --version

# rbenv 설치
$ brew install rbenv

# Ruby 설치
$ rbenv install 3.1.0

# Ruby 전역 버전 설정
$ rbenv global 3.1.0

# Ruby 버전 다시 확인 (둘이 같아야함. 다르다면 환경변수 잡기)

# .zshrc 파일 경로로 이동해서 편집기 실행. 아무거나 상관X.. 다룰줄만 안다면
$ vi ~/.zshrc
$ nano ~/.zshrc

# .zshrc 파일이 열린다. 난 이미 설정해둔게 많아서 최하단에 아래 환경변수를 넣는다...
eval "$(rbenv init - zsh)"

# 파일 저장하고 닫고 나오기. 수정 내용을 반영.
$ source ~/.zshrc

# Ruby 버전 다시 확인해서 둘 다 3.1.0으로 일치하는 걸 확인

jekyll 설치 후 테스트 사이트 접속하기 (sudo 안 붙여도 동작한다면 안 붙여도 된다.)

# bundler 설치
$ sudo gem install bundler -v 2.4.22

# jekyll 설치
$ sudo gem install bundler jekyll

# jekyll로 서버 돌릴 테스트 사이트 생성
$ jekyll new my-awesome-site

# 경로 이동
$ cd my-awesome-site

# 서버 실행
$ bundle exec jekyll serve

크롬 브라우저에서 http://localhost:4000 접속 확인

이러면 맨 처음에 있던 jekyll 공식 사이트의 'Quik-start Instructions'가 성공적으로 끝난 것이다.

이 다음에 GitHub Page로 사용하고 싶은 테마를 가져오고, 해당 테마가 로컬에서 어떻게 보이는지 확인하고 싶을 때,

터미널에서 clone해온 테마 프로젝트 경로로 이동하고 jekyll server 가동 후,

크롬 브라우저에서 똑같이 localhost:4000에서 확인하면 된다.

Why GitHub Desktop을 설치하나?

Terminal에서 git 명령어를 쓰기보단 (완전 모르진 않지만 그냥 본인이 게을러서 그런 듯)

Windows에선 SourceTree, mac에선 Fork로 여러 프로젝트나 브랜치 checkout을 했던지라

~~mac Fork로 GitHub Pages에 쓸 프로젝트에 commit, push했더니 뭔가 깔끔하게 동작하지 않아보였다.(잘 몰라서 그랬을지도)~~

(앗. 첨에 안됐었는데 다시 하니까 잘만 된다. 그땐 다른 사유로 안됐었나보다. 기존에 GUI 안 썼던 사람들은 GitHub Desktop 쓰면서 익숙해지면 될 것 같다. 나는 Fork로 돌아간다...후후..)

그래서 검색해보니 대다수가 Terminal에서 git 명령어 사용, GitHub Desktop에서 commit push하는 글이 많아서

GitHub Desktop으로 해보니 동작했다.

GitHub Desktop 공식 다운로드

macOS에 따라 잘 다운 받자. ( x64.zip, arm64.zip 다름)

위에 다운로드 받다가 흠칫 하고 다시 밑의 Apple Silicon을 다운 받았다.

GitHub Desktop을 실행한다. 일단 실행만 해본다.

이 뒤는 나중에 GitHub Pages에 쓸 테마를 가져와서 clone하고 나면

Add an Existing Repository from your Local... 선택하고

Choose 해서 clone한 경로 열면 된다.

주의

GitHub Pages를 단순 로컬에서만 돌리는 용도로만 쓰려고 사용하진 않을거다.

GitHub Actions에서 빌드 배포를 해서 서버리스처럼 사용할텐데

이때 Build & Deploy는 실행한 OS platform에 따라서 영향을 많이 받는다.

나는 mac Apple Silicon으로 GitHub Pages 진행을 했기 때문에

Linux platform 상이 오류 등이 존재했다.

테마 적용 글에도 적어놨지만

동일 mac에서 여러번 Chirpy 테마로 테스트 해본 결과 (다른 경우는 모르겠다.)

clone 하고 파일 추가수정삭제한 후 (여기!) -> commit, push 하기 전에 꼭!

clone project 경로로 이동해서, 아래 명령어로 linux platform을 추가해줘야했다.

  $ bundle lock --add-platform x86_64-linux

clone한 프로젝트를 삭제했다가, 다시 clone했을 때도 동일하게 추가해줘야했던거로 기억한다(아님 말고 다행이고...)

보통 1번 clone하면 웬만해서 쭉 쓰니까 엄청 귀찮진 않을 것 같다.

macOS - intellij, Xcode, VS Code 단축키 shortcut

Mary's log — Mon, 6 Jan 2025 22:57:06 +0900

macOS

Space < 미리보기의 팝업

팝업에서 '미리보기' 열기 = Cmd(⌘) + 아래 화살표

macOS memo 단축키

서체보기 : cmd + T

서체 색상 보기 : cmd + shift + C

Intellij shortcut

단축키 안 먹히면 이거로 되어있는지 확인

줄 복사	Cmd(⌘) + D
줄 삭제	Cmd(⌘) + X
줄 이동	Cmd(⌘) + Shift + 위/아래
Class Run	Ctrl(^) + R
단어 일괄 변경	func + shift + F6
코드 정렬	Opt(⌥) + Cmd(⌘) + L

설정>에디터>라이브템플릿>+ 라이브템플릿>new

$TYPE$<$GENERIC_TYPE$> $END$ = new $TYPE$<>();

Xcode shortcut

줄 복사	Cmd(⌘) + D
줄 삭제 *	Opt(⌥) + Cmd(⌘) + .
줄 이동	Opt(⌥) + Cmd(⌘) + [ ]
Navigator	Cmd(⌘) + 0
Inspector	Opt(⌥) + Cmd(⌘) + 0
시뮬 캡쳐	Cmd(⌘) + S
프로젝트 Run	Cmd(⌘) + R
들여쓰기 정리 (전체선택)	Cmd(⌘) + I
숨긴 항목 표시	Shift + Cmd(⌘) + .
이모티콘	Ctrl(^) + Cmd(⌘) + Space

[iOS - swift] 2. custom shortcut (커스텀 단축키) 만드는 방법

VS Code shortcut

Terminal 이동	ctrl(^) + `
줄 복사	Opt(⌥) + Shift(⇧) + 위/아래
줄 이동	Opt(⌥) + 위/아래
줄 삭제	Shift(⇧) + Cmd(⌘) + K

OOP, SOLID, 디자인 패턴

Mary's log — Sun, 5 Jan 2025 16:57:21 +0900

OOP의 기본 개념 정리

(Object-Oriented Programming)

주요 개념 :

• 객체(Object):	데이터와 이를 조작하는 메서드의 집합.
• 클래스(Class):	객체를 생성하기 위한 설계도.
• 캡슐화(Encapsulation):	데이터를 숨기고 공개된 메서드로만 접근하도록 제한.
• 상속(Inheritance):	기존 클래스의 특성과 동작을 재사용.
• 다형성(Polymorphism):	동일한 인터페이스로 다양한 동작을 수행.
• 추상화(Abstraction):	불필요한 세부 사항을 숨기고 중요한 것만 드러냄.

학습 방법:
• ‘자바의 정석’ 책에서 관련 챕터를 다시 읽고, 직접 코드 예제를 작성.
• 각 개념을 설명하는 5줄 이하의 코드를 스스로 작성하며 이해 확인.

SOLID 원칙

OOP의 설계 원칙을 체계적으로 정리한 것으로, 좋은 객체 지향 설계를 돕습니다.

1. SRP (Single Responsibility Principle):
	• 클래스는 하나의 책임만 가져야 합니다.
	• 한 클래스의 변경 사유는 하나뿐이어야 합니다.
	• 예제: User 클래스는 사용자 데이터만 관리하고, 로그 출력은 별도의 Logger 클래스에서 처리.
2. OCP (Open/Closed Principle):
	• 클래스는 확장에는 열려 있어야 하고, 수정에는 닫혀 있어야 합니다.
	• 예제: 인터페이스나 추상 클래스를 사용해 새로운 기능을 추가.
3. LSP (Liskov Substitution Principle):
	• 자식 클래스는 부모 클래스의 행위를 대체할 수 있어야 합니다.
	• 예제: Rectangle 클래스가 Square로 대체되어도 정상 작동해야 함.
4. ISP (Interface Segregation Principle):
	• 인터페이스는 사용하지 않는 메서드가 포함되지 않도록 분리.
	• 예제: 대규모 인터페이스 대신 작은 인터페이스로 나눔.
5. DIP (Dependency Inversion Principle):
	• 고수준 모듈은 저수준 모듈에 의존하지 않고 추상화에 의존해야 함. 1. 고수준 모듈 (High-Level Module) : 핵심 로직을 담고 있는 부분. 예: 앱에서 사용자가 입력한 값을 처리하거나 계산하는 비즈니스 로직. 2. 저수준 모듈 (Low-Level Module) : 실제로 동작을 수행하는 구체적인 구현. 예: 데이터를 저장하는 DB 연결 코드, 특정 API 호출.
	• 예제: 구체 클래스 대신 인터페이스에 의존. 추상 클래스란, 공통적인 동작을 정의한 틀(인터페이스나 추상 클래스). 구체 클래스란, 저 추상화를 실제로 '구현'하는 클래스.
	결론 : 고수준 모듈이 직접 저수준 모듈을 사용하지 않고, 추상화(인터페이스)를 통해 연결되게 만들기

디자인 패턴

• 소프트웨어 설계 문제를 해결하기 위한 재사용 가능한 설계 템플릿.

• 흔히 겪는 문제에 대한 해결책을 정리해 둔 것.

1. 생성 패턴 (Creational Patterns)
	객체를 생성하는 방법과 관련.
	• Singleton: 인스턴스를 하나만 만들고 공유할 때 사용.
	• Factory: 객체 생성을 별도의 메서드로 분리해 관리.
2. 구조 패턴 (Structural Patterns)
	클래스나 객체 간의 관계를 조직적으로 설계.
	• Adapter: 서로 다른 인터페이스를 연결.
	• Composite: 객체를 트리 구조로 구성.
3. 행위 패턴 (Behavioral Patterns)
	객체 간의 상호작용과 책임 분리를 다룸.
	• Observer: 한 객체의 변화가 다른 객체들에게 알림.
	• Strategy: 행동을 캡슐화하고 동적으로 교체 가능.

학습 방법:
• 각 원칙에 대해 이해한 뒤, 이를 적용한 간단한 코드 예제를 작성.
• 기존에 작성한 코드에서 SOLID 원칙이 어긋난 사례를 찾아 수정.

OOP와 관련된 개념들을 트리 구조로 큰 그림 잡기

• 기본 원칙
	• 캡슐화
	• 상속
	• 다형성
	• 추상화
• SOLID 원칙
	• SRP
	• OCP
	• LSP
	• ISP
	• DIP
• 디자인 패턴
	• 생성 패턴: Singleton, Factory
	• 구조 패턴: Adapter, Composite
	• 행위 패턴: Observer, Strategy

학습 방법:
1. 온라인 강의
• 유튜브: “나도코딩” 또는 “동빈나”의 객체 지향 강의.
• 인프런: 객체 지향 설계와 SOLID 강의 추천.
2. 추천 도서
• ‘Effective Java’ by Joshua Bloch
• ‘객체 지향의 사실과 오해’ by 조영호
3. 프로젝트로 연습
• 간단한 애플리케이션(예: To-Do List)에서 객체 지향 원칙을 적용해보기.

[mac] notion 설치

Mary's log — Wed, 23 Oct 2024 11:30:41 +0900

1. 공식 사이트 - 다운로드

'Notion-3.17.0-universal.dmg' 파일 다운로드