๐Ÿ“˜ SmartURLs ํ…œํ”Œ๋ฆฟ ๊ฐ€์ด๋“œ (v1.4.0+)

์ด ๊ฐ€์ด๋“œ๋Š” SmartURLs์˜ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ ๊ธฐ๋Šฅ ์‚ฌ์šฉ ๋ฐฉ๋ฒ•์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค. ํ…œํ”Œ๋ฆฟ์€ ํ•œ ์ค„ ์ž…๋ ฅ ํ•„๋“œ์— ์ž‘์„ฑํ•˜์ง€๋งŒ, $nl ํ† ํฐ์„ ์‚ฌ์šฉํ•˜์—ฌ ์—ฌ๋Ÿฌ ์ค„ ์ถœ๋ ฅ์„ ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

SmartURLs๋Š” ์˜๋„์ ์œผ๋กœ ๊ฐ€๋ณ์Šต๋‹ˆ๋‹ค. ์›นํŽ˜์ด์ง€ ๋‚ด์šฉ์„ ์ฝ์ง€ ์•Š์œผ๋ฉฐ URL๊ณผ ๋ธŒ๋ผ์šฐ์ € ํƒญ ์ •๋ณด๋งŒ์œผ๋กœ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค.

1. ๊ธฐ๋ณธ ํ† ํฐ

SmartURLs๋Š” ํƒญ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ์™€ ํ˜„์žฌ URL์„ ๊ธฐ๋ฐ˜์œผ๋กœ ํ† ํฐ์„ ๊ต์ฒดํ•ฉ๋‹ˆ๋‹ค.

ํ† ํฐ ์„ค๋ช… ์ถœ๋ ฅ ์˜ˆ์‹œ
$title ํƒญ์— ํ‘œ์‹œ๋˜๋Š” ํŽ˜์ด์ง€ ์ œ๋ชฉ Why the Moon?
$title(html) HTML ์ด์Šค์ผ€์ดํ”„๋œ ํŽ˜์ด์ง€ ์ œ๋ชฉ (&, <, >, ", '๋ฅผ ์—”ํ‹ฐํ‹ฐ๋กœ ๋ณ€ํ™˜). HTML ํƒœ๊ทธ/์†์„ฑ์—์„œ ์•ˆ์ „ํ•˜๊ฒŒ ์‚ฌ์šฉ ๊ฐ€๋Šฅ. Rock &amp; Roll &lt;Best Hits&gt;
(์ œ๋ชฉ ์˜ˆ: โ€œRock & Roll <Best Hits>โ€)
$url ์ „์ฒด URL https://www.youtube.com/watch?v=bmC-FwibsZg
$domain ํ˜ธ์ŠคํŠธ๋ช…๋งŒ www.youtube.com
$path URL์˜ ๊ฒฝ๋กœ ๋ถ€๋ถ„ /watch
$basename ๊ฒฝ๋กœ์˜ ๋งˆ์ง€๋ง‰ ์„ธ๊ทธ๋จผํŠธ watch
$idx ํƒญ ์ธ๋ฑ์Šค (1๋ถ€ํ„ฐ ์‹œ์ž‘) 3
$date ๋กœ์ปฌ ๋‚ ์งœ (YYYY-MM-DD) 2025-01-12
$time ๋กœ์ปฌ ์‹œ๊ฐ„ (HH:MM:SS) 14:03:55
$date(utc) UTC ๋‚ ์งœ 2025-01-12
$time(utc) UTC ์‹œ๊ฐ„ 05:03:55
$nl ์ค„ ๋ฐ”๊ฟˆ ์‚ฝ์ž… (์ถœ๋ ฅ์— ์ค„ ๋ฐ”๊ฟˆ ์ƒ์„ฑ)

โš ๏ธ $nl์— ๋Œ€ํ•œ ์ฐธ๊ณ  ์‚ฌํ•ญ: ๋ณต์‚ฌ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ์—์„œ๋งŒ ์ง€์›๋ฉ๋‹ˆ๋‹ค. ํ…์ŠคํŠธ์—์„œ ์—ด๊ธฐ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ์—์„œ๋Š” ์‚ฌ์šฉํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ๋ณต์‚ฌ์™€ ์—ด๊ธฐ์— ๋™์ผํ•œ ํ…œํ”Œ๋ฆฟ์„ ์žฌ์‚ฌ์šฉํ•˜๋ ค๋ฉด ์—ด๊ธฐ ํ…œํ”Œ๋ฆฟ์—์„œ $nl์„ ํ”ผํ•˜๊ฑฐ๋‚˜ ์Šค๋งˆํŠธ(์ž๋™ ๊ฐ์ง€) ๋ชจ๋“œ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.

โš ๏ธ $title(html)์— ๋Œ€ํ•œ ์ฐธ๊ณ  ์‚ฌํ•ญ: ๋ณต์‚ฌ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ์—์„œ๋งŒ ์ง€์›๋ฉ๋‹ˆ๋‹ค. ํ…์ŠคํŠธ์—์„œ ์—ด๊ธฐ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ์€ ์ด ํ† ํฐ์„ ์ฒ˜๋ฆฌํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์—ด๊ธฐ ํ…œํ”Œ๋ฆฟ์˜ ๊ฒฝ์šฐ ๋Œ€์‹  $title์„ ์‚ฌ์šฉํ•˜์„ธ์š”.

์œ„์—์„œ ์‚ฌ์šฉ๋œ ์˜ˆ์‹œ URL ๋ฐ ์ œ๋ชฉ

ํ† ํฐ์ด ์–ด๋–ป๊ฒŒ ํ™•์žฅ๋˜๋Š”์ง€ ๋ณด์—ฌ์ฃผ๊ธฐ ์œ„ํ•ด ๋‹ค์Œ ์˜ˆ์‹œ๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค:

๐Ÿ“˜ ์ œ๋ชฉ

Why the Moon?

๐Ÿ”— URL

https://www.youtube.com/watch?v=bmC-FwibsZg

์ด URL์—์„œ:

๋‚ ์งœ์™€ ์‹œ๊ฐ„์€ ์˜ˆ์‹œ์ด๋ฉฐ, ์‹ค์ œ ์ถœ๋ ฅ์€ ์‹œ์Šคํ…œ ์‹œ๊ณ„์— ๋”ฐ๋ผ ๋‹ค๋ฆ…๋‹ˆ๋‹ค.

2. ์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜ ํ† ํฐ

SmartURLs๋Š” URL์—์„œ ์ง์ ‘ ์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์ถ”์ถœํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ”ค ๊ตฌ๋ฌธ

$<param>

๐Ÿ”— URL ์˜ˆ์‹œ

https://www.youtube.com/watch?v=bmC-FwibsZg&t=123
ํ† ํฐ ์ถœ๋ ฅ
$v bmC-FwibsZg
$t 123

๋งค๊ฐœ๋ณ€์ˆ˜๊ฐ€ ์กด์žฌํ•˜์ง€ ์•Š์œผ๋ฉด ๊ทธ ๊ฐ’์€ ๋นˆ ๋ฌธ์ž์—ด์ด ๋ฉ๋‹ˆ๋‹ค.

โš ๏ธ ์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜ ํ† ํฐ์— ๋Œ€ํ•œ ์ฐธ๊ณ  ์‚ฌํ•ญ: ์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜ ํ† ํฐ(์˜ˆ: $v, $id, $tag ๋“ฑ)์€ ๋ณต์‚ฌ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ์—์„œ๋งŒ ํ‰๊ฐ€๋ฉ๋‹ˆ๋‹ค. ํ…์ŠคํŠธ์—์„œ ์—ด๊ธฐ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ์—์„œ๋Š” ํ‰๊ฐ€๋˜์ง€ ์•Š์œผ๋ฏ€๋กœ ์—ด๊ธฐ ํ…œํ”Œ๋ฆฟ์—์„œ ์‚ฌ์šฉํ•˜์ง€ ๋งˆ์„ธ์š”.

3. ์กฐ๊ฑด๋ถ€ ๋ธ”๋ก

์กฐ๊ฑด๋ถ€ ๋ธ”๋ก์„ ์‚ฌ์šฉํ•˜๋ฉด ํ…œํ”Œ๋ฆฟ์ด ํŠน์ • ์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜๊ฐ€ ์กด์žฌํ•  ๋•Œ๋งŒ ํŠน์ • ํ…์ŠคํŠธ๋ฅผ ์ถœ๋ ฅํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ”ค ๊ตฌ๋ฌธ

๐Ÿ”น ๋‹จ์ผ ๋งค๊ฐœ๋ณ€์ˆ˜

{{q=v: ... }}

๐Ÿ”ธ ๋‹ค์ค‘ ๋งค๊ฐœ๋ณ€์ˆ˜ (AND ์กฐ๊ฑด)

{{q=v,t: ... }}

์กฐ๊ฑด๋ถ€ ๋ธ”๋ก ๋‚ด์—์„œ:

์กฐ๊ฑด์ด ์ถฉ์กฑ๋˜์ง€ ์•Š์œผ๋ฉด ์ „์ฒด ๋ธ”๋ก์ด ์ถœ๋ ฅ์—์„œ ์ œ๊ฑฐ๋ฉ๋‹ˆ๋‹ค.

โš ๏ธ ์กฐ๊ฑด๋ถ€ ๋ธ”๋ก์— ๋Œ€ํ•œ ์ฐธ๊ณ  ์‚ฌํ•ญ: ์กฐ๊ฑด๋ถ€ ๋ธ”๋ก(์˜ˆ: ``)์€ ๋ณต์‚ฌ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ์—์„œ๋งŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ…์ŠคํŠธ์—์„œ ์—ด๊ธฐ ์ปค์Šคํ…€ ํ…œํ”Œ๋ฆฟ์—์„œ๋Š” ์ž‘๋™ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. URL์„ ์—ด ๋•Œ ์œ ์—ฐํ•œ ํ•„ํ„ฐ๋ง์ด ํ•„์š”ํ•œ ๊ฒฝ์šฐ ์Šค๋งˆํŠธ(์ž๋™ ๊ฐ์ง€) ๋ชจ๋“œ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.

4. ํ…œํ”Œ๋ฆฟ ์˜ˆ์‹œ ๋ฐ ํŒจํ„ด

ํ…œํ”Œ๋ฆฟ์€ ํ•œ ์ค„๋กœ ์ž‘์„ฑ๋˜์ง€๋งŒ $nl์„ ํ†ตํ•ด ์—ฌ๋Ÿฌ ์ค„์„ ์ถœ๋ ฅํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ด ์„น์…˜์—์„œ ์‚ฌ์šฉ๋˜๋Š” ์˜ˆ์‹œ URL๊ณผ ์ œ๋ชฉ:

๐Ÿ“˜ ์ œ๋ชฉ

Why the Moon?

๐Ÿ”— URL

https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.1 Markdown: ์ œ๋ชฉ + URL

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

$title$nl$url

๐Ÿ’ฌ ์ถœ๋ ฅ

Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.2 Markdown ๋ฆฌ์ŠคํŠธ ํ•ญ๋ชฉ

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

- [$title]($url)

๐Ÿ’ฌ ์ถœ๋ ฅ

- [Why the Moon?](https://www.youtube.com/watch?v=bmC-FwibsZg&t=123)

4.3 YouTube ๋™์˜์ƒ ID (์กด์žฌํ•  ๋•Œ๋งŒ)

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

{{q=v:Video ID: $v$nl}}$title$nl$url

๐Ÿ’ฌ ์ถœ๋ ฅ

Video ID: bmC-FwibsZg
Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

v=๊ฐ€ ์—†์œผ๋ฉด:

Why the Moon?
https://example.com/page

4.4 YouTube ์ธ๋„ค์ผ URL ์ƒ์„ฑ

์•Œ๋ ค์ง„ YouTube ์ธ๋„ค์ผ ํŒจํ„ด ๊ธฐ๋ฐ˜:

https://img.youtube.com/vi/VIDEO_ID/maxresdefault.jpg

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

{{q=v:Thumbnail: https://img.youtube.com/vi/$v/maxresdefault.jpg$nl}}$title$nl$url

๐Ÿ’ฌ ์ถœ๋ ฅ

Thumbnail: https://img.youtube.com/vi/bmC-FwibsZg/maxresdefault.jpg
Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.5 YouTube ์ธ๋„ค์ผ ์‚ฝ์ž… (Markdown)

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

{{q=v:![thumb](https://img.youtube.com/vi/$v/mqdefault.jpg)$nl}}[$title]($url)

๐Ÿ’ฌ ์ถœ๋ ฅ

![thumb](https://img.youtube.com/vi/bmC-FwibsZg/mqdefault.jpg)
[Why the Moon?](https://www.youtube.com/watch?v=bmC-FwibsZg&t=123)

4.6 ํƒ€์ž„์Šคํƒฌํ”„ (๊ฐ€๋Šฅํ•œ ๊ฒฝ์šฐ)

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

{{q=t:Timestamp: $t sec$nl}}$title$nl$url

๐Ÿ’ฌ ์ถœ๋ ฅ

Timestamp: 123 sec
Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.7 ๋‹ค์ค‘ ๋งค๊ฐœ๋ณ€์ˆ˜ ์กฐ๊ฑด

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

{{q=v,t:Video: $v ($t sec)$nl}}$url

๐Ÿ’ฌ ์ถœ๋ ฅ

Video: bmC-FwibsZg (123 sec)
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.8 ๋กœ๊ทธ ํ˜•์‹ (๋„๋ฉ”์ธ + ๊ฒฝ๋กœ)

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

[$domain] $path$nl$url

๐Ÿ’ฌ ์ถœ๋ ฅ

[www.youtube.com] /watch
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.9 ํŒŒ์ผ ์ด๋ฆ„ ์Šคํƒ€์ผ ์ œ๋ชฉ

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

## $basename: $title$nl$url

๐Ÿ’ฌ ์ถœ๋ ฅ

## watch: Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.10 ๋ฏธ๋‹ˆ๋ฉ€๋ฆฌ์ŠคํŠธ

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

$title โ€” $url

๐Ÿ’ฌ ์ถœ๋ ฅ

Why the Moon? โ€” https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.11 ์ผ์ผ ๋กœ๊ทธ ํ•ญ๋ชฉ

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

- [$title]($url) โ€” $date $time

๐Ÿ’ฌ ์ถœ๋ ฅ

- [Why the Moon?](https://www.youtube.com/watch?v=bmC-FwibsZg&t=123) โ€” 2025-01-12 14:03:55

4.12 ๊ตฌ๋ถ„์ž๊ฐ€ ์žˆ๋Š” ์—ฌ๋Ÿฌ ์ค„

๐Ÿ›  ํ…œํ”Œ๋ฆฟ

$title$nl$url$nl---$nl$domain

๐Ÿ’ฌ ์ถœ๋ ฅ

Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123
---
www.youtube.com

5. ์ œํ•œ์‚ฌํ•ญ

SmartURLs๋Š” ์˜๋„์ ์œผ๋กœ ๋‹จ์ˆœํ•˜๊ฒŒ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค.

โŒ SmartURLs๊ฐ€ ํ•˜์ง€ ์•Š๋Š” ๊ฒƒ:

โœ”๏ธ SmartURLs๊ฐ€ ์˜ค์ง ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ:

์ด๊ฒƒ์€ ๋ชจ๋“  ์›น์‚ฌ์ดํŠธ์—์„œ ์ผ๊ด€๋œ ๋™์ž‘์„ ๋ณด์žฅํ•ฉ๋‹ˆ๋‹ค.

6. ๋ฒ„์ „ ํ˜ธํ™˜์„ฑ

์ด ๊ธฐ๋Šฅ์€ ๋‹ค์Œ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค: SmartURLs v1.4.0 ์ด์ƒ

7. ํ”ผ๋“œ๋ฐฑ

๊ธฐ๋Šฅ ์š”์ฒญ์ด๋‚˜ ์งˆ๋ฌธ์ด ์žˆ์œผ๋ฉด ์—ฌ๊ธฐ์—์„œ ์ด์Šˆ๋ฅผ ์—ด์–ด์ฃผ์„ธ์š”:

https://github.com/isshiki/SmartURLs/issues