﻿==============================================================
 Cliply 사용설명서
 개발자용 스니펫·명령어 노트 (Windows 10 / 11, 64비트)
==============================================================

자주 쓰는 PowerShell, Docker, SQL, Bash, Git 명령어를 저장해 두고
어느 프로그램에서든 단축키 한 번으로 찾아 클립보드에 복사합니다.

  단축키(Ctrl+Shift+Space) → 검색어 입력 → Enter → 원래 창에서 Ctrl+V


--------------------------------------------------------------
1. 설치와 실행
--------------------------------------------------------------

설치 과정은 없습니다. .NET 등 다른 프로그램도 따로 설치할 필요가 없습니다.

  1) 내려받은 zip 파일을 마우스 오른쪽 버튼 → [속성] → 아래쪽
     [차단 해제]에 체크 → [확인]
     (인터넷에서 받은 파일이라 Windows가 표시해 둔 것을 풀어 줍니다)

  2) zip 압축을 원하는 폴더에 풉니다.
     예) C:\Tools\Cliply

  3) Cliply.exe 를 실행합니다.

  4) 창은 뜨지 않고 작업 표시줄 오른쪽 아래 알림 영역(트레이)에
     파란색 >_ 아이콘이 생깁니다. 아이콘이 안 보이면 ^ 를 눌러
     숨겨진 아이콘을 확인하세요.

[처음 실행할 때 "Windows의 PC 보호" 창이 뜨는 경우]
  코드 서명이 없는 프로그램이라 Windows SmartScreen이 경고합니다.
  [추가 정보] → [실행]을 누르면 됩니다. 한 번만 하면 됩니다.
  정품인지 확인하려면 Cliply.exe 오른쪽 클릭 → [속성] → [자세히] 탭에서
  회사가 "애드소프트 (Addsoft)"인지 보세요.

[화면 언어]
  Windows 표시 언어가 한국어면 한국어, 그 밖에는 영어로 나옵니다.
  바꾸려면 트레이 아이콘 오른쪽 클릭 → [설정] → 언어 → [저장].
  화면이 바로 바뀝니다.

[Windows 시작할 때 자동으로 실행하려면]
  트레이 아이콘 오른쪽 클릭 → [설정] → "Windows 시작 시 자동 실행" 체크
  → [저장]. Cliply.exe 를 다른 폴더로 옮겼다면 옮긴 위치에서
  한 번 실행해 주면 경로가 다시 맞춰집니다.


--------------------------------------------------------------
2. 빠른 검색 (가장 많이 쓰는 기능)
--------------------------------------------------------------

어떤 프로그램을 쓰고 있든 Ctrl+Shift+Space 를 누르면
마우스가 있는 화면에 검색 창이 뜹니다.

  키          동작
  ----------  ------------------------------------------------
  입력        바로 검색 (최대 30개)
  ↑ / ↓       선택 이동 (끝에서 처음으로 돌아감)
  Enter       복사하고 닫기 → 원래 창에서 Ctrl+V 로 붙여넣기
  Esc         검색어가 있으면 지우기, 없으면 닫기
  Ctrl+E      선택한 스니펫을 관리 창에서 편집
  Ctrl+N      입력한 검색어를 제목으로 새 스니펫 만들기
  Ctrl+P      목록 위에 고정 / 고정 해제

  - 마우스로 클릭하면 선택, 더블클릭하면 그 항목을 복사합니다.
  - 검색 창 밖을 누르면 자동으로 숨습니다.
  - 단축키는 설정에서 바꿀 수 있습니다.

[검색 문법]

  입력                  의미
  --------------------  ------------------------------------
  log tail              모든 단어가 들어간 것 (AND)
  #docker               태그가 docker 인 것 (여러 개면 모두)
  @sql                  언어가 sql 인 것
  "docker logs"         이 구문이 그대로 들어간 것
  #docker @bash logs    위 조건을 함께

  - 단어 일부만 입력해도 찾습니다. (dock → docker, 한글도 가능)
  - 고정한 것 → 제목이 맞는 것 → 자주 쓴 것 순서로 보여 줍니다.


--------------------------------------------------------------
3. 변수 (명령어의 바뀌는 부분)
--------------------------------------------------------------

본문에 {{이름}} 을 넣어 두면 복사할 때 값을 묻는 창이 뜹니다.

  docker logs -f --tail {{줄수:100}} {{컨테이너}}

  표기              의미
  ----------------  ----------------------------------------
  {{이름}}          변수
  {{이름:기본값}}   기본값이 있는 변수
  \{{               변수가 아니라 {{ 글자 그대로

  - 같은 이름을 여러 번 써도 한 번만 입력하면 모두 바뀝니다.
  - 변수 이름에는 한글, 영문, 숫자, _, - 를 쓸 수 있습니다.
  - 입력 창: Enter 다음 칸(마지막 칸이면 복사), Ctrl+Enter 바로 복사,
    Esc 취소
  - 마지막으로 입력한 값을 기억해 두었다가 다음에 채워 줍니다.


--------------------------------------------------------------
4. 스니펫 관리 창
--------------------------------------------------------------

트레이 아이콘을 더블클릭하거나, 오른쪽 클릭 → [스니펫 관리].

  왼쪽: 검색과 목록 (제목, 언어, 태그, 고정, 사용 횟수)
  오른쪽: 편집 (제목, 언어, 태그, 본문, 설명)

  키                  동작
  ------------------  -----------------------------------
  Ctrl+N              새로 만들기
  Ctrl+S              저장
  Ctrl+P              고정 / 고정 해제
  Ctrl+F              검색 칸으로 이동
  Del  (목록에서)     삭제 (확인 후)
  Ctrl+C (목록에서)   복사

  - 태그: 태그 칸에 입력하고 Enter 또는 쉼표(,)로 추가합니다.
    이미 쓰는 태그는 자동완성됩니다. 빈 칸에서 Backspace 를 누르면
    마지막 태그가 빠집니다.
  - 제목과 본문은 꼭 입력해야 합니다. 제목은 200자까지입니다.
  - 저장하지 않고 다른 항목을 고르거나 창을 닫으면 저장할지 묻습니다.
  - 창의 X 를 눌러도 프로그램은 꺼지지 않고 트레이에 남습니다.

처음 실행하면 그때의 화면 언어로 예시 스니펫 11개가 들어 있습니다.
필요 없으면 지우세요.


--------------------------------------------------------------
5. 백업 · 옮기기 (내보내기 / 가져오기)
--------------------------------------------------------------

관리 창 왼쪽 아래 [내보내기] → JSON 파일로 저장합니다.
다른 PC에서 [가져오기] 로 그 파일을 읽으면 그대로 옮겨집니다.

  - 가져오기 전에 현재 데이터를 자동으로 백업합니다.
    (%LOCALAPPDATA%\Cliply\backup\cliply-날짜-시각.db)
  - 같은 스니펫이 양쪽에 있으면 더 최근에 고친 쪽을 남깁니다.
  - 결과는 "추가 N건 / 갱신 N건 / 건너뜀 N건" 으로 알려 줍니다.


--------------------------------------------------------------
6. 설정
--------------------------------------------------------------

트레이 아이콘 오른쪽 클릭 → [설정]

  - 빠른 검색 단축키: 칸을 누른 뒤 원하는 키 조합을 누릅니다.
    (Ctrl, Alt, Shift, Win 중 하나 이상 + 다른 키)
    다른 프로그램이 이미 쓰는 단축키면 바꾸지 않고 알려 줍니다.
  - Windows 시작 시 자동 실행
  - 복사 후 "복사됨" 표시
  - 언어: Windows 언어 따름 / 한국어 / English
  - 테마: 시스템 설정 따름 / 라이트 / 다크
  - 본문 글꼴: Consolas (D2Coding 을 설치하면 고를 수 있음)


--------------------------------------------------------------
7. 데이터 위치
--------------------------------------------------------------

모든 데이터는 이 PC 안에만 저장됩니다. 인터넷으로 보내지 않습니다.

  스니펫    %LOCALAPPDATA%\Cliply\cliply.db
  설정      %LOCALAPPDATA%\Cliply\settings.json
  로그      %LOCALAPPDATA%\Cliply\logs\  (7일 지나면 자동 삭제)
  백업      %LOCALAPPDATA%\Cliply\backup\

  ※ 탐색기 주소창에 %LOCALAPPDATA%\Cliply 를 입력하면 열립니다.


--------------------------------------------------------------
8. 새 버전으로 바꾸기
--------------------------------------------------------------

  1) 트레이 아이콘 오른쪽 클릭 → [종료]
  2) 새 Cliply.exe 로 덮어쓰기
  3) 다시 실행

데이터는 %LOCALAPPDATA%\Cliply 에 있으므로 그대로 유지됩니다.


--------------------------------------------------------------
9. 지우기 (제거)
--------------------------------------------------------------

  1) 설정에서 "Windows 시작 시 자동 실행"을 껐는지 확인 → [저장]
  2) 트레이 아이콘 오른쪽 클릭 → [종료]
  3) Cliply.exe 가 있는 폴더를 지웁니다.
  4) 데이터까지 지우려면 %LOCALAPPDATA%\Cliply 폴더도 지웁니다.
     (필요하면 먼저 [내보내기]로 백업하세요)


--------------------------------------------------------------
10. 자주 묻는 질문
--------------------------------------------------------------

Q. 단축키를 눌러도 검색 창이 안 떠요.
A. 트레이에 아이콘이 있는지 확인하세요. 다른 프로그램이 같은 단축키를
   쓰면 시작할 때 알림이 뜹니다. 설정에서 다른 조합으로 바꾸세요.

Q. Cliply.exe 를 한 번 더 실행하면?
A. 새로 켜지지 않고, 이미 켜져 있는 Cliply 의 검색 창이 뜹니다.

Q. 처음 실행이 조금 느려요.
A. 첫 실행 때 필요한 파일을 풀어 두느라 2~3초 걸립니다.
   그 뒤로는 트레이에 상주하므로 검색 창은 바로 뜹니다.

Q. 영어 화면으로 쓸 수 있나요?
A. 네. 설정 → 언어에서 English 를 고르세요. 영문 설명서는
   같은 폴더의 User Guide.txt 입니다.

Q. 문제가 생기면?
A. %LOCALAPPDATA%\Cliply\logs 의 로그 파일을 함께 보내 주세요.


--------------------------------------------------------------
 만든 곳: 애드소프트 (www.addsoft.co.kr)
--------------------------------------------------------------
