Spintax 구문 참조

spintax 템플릿 마크업에 대한 완전한 참조. 구문은 Generating The Web (GTW) 표준과 호환됩니다.

열거 { }

목록에서 무작위로 하나의 옵션을 선택합니다.

{option1|option2|option3}

예제

{blue|grey|clear}
{|online|internet} casino        ← empty option = sometimes nothing
{1X{S|s}lots}                    ← nested enumerations
{license {|#8048} from Curacao}  ← nesting with empty option

규칙

• 구분자: { 및 }
• 구분자: |
• 임의의 깊이까지 중첩 지원
• 빈 옵션은 유효 (빈 문자열 생성)
• 가장 안쪽 표현식에서 바깥쪽으로 해석

순열 [ ]

N개의 요소를 선택, 셔플, 구분자로 결합합니다.

단순 순열

모든 요소 포함, 공백으로 구분:

[1|2|3|4]

출력 예: 1 4 3 2, 2 3 4 1, 3 2 4 1

구분자 포함

시작 부분의 < >에 통일 구분자 지정:

[<, > 1|2|3|4]

출력 예: 2, 1, 4, 3, 4, 3, 2, 1

중요: [과 <구분자> 사이에 공백 없음.

요소별 구분자

각 옵션은 이전 | 앞에 <sep>로 고유한 구분자를 정의할 수 있습니다:

[<, > 1|2|3 < and >|4]

출력 예: 1, 3, 2 and 4, 3, 1, 2 and 4

조합이 있는 순열

구성 가능한 최소/최대 요소 수와 구분자:

[<minsize=1;maxsize=3;sep=", ";lastsep=" and "> apple|plum|orange|apricot]

출력 예: apple, plum and orange, apple and apricot, orange

구성 매개변수

순열 규칙

• 구분자: [ 및 ]
• 구성 블록 <...>은 [ 바로 뒤에 와야 합니다
• 구성 매개변수는 세미콜론으로 구분
• 구성의 문자열 값은 따옴표로 감쌈: sep=", "
• 열거와 순열은 옵션 내에서 중첩 가능
• HTML 요소도 옵션이 될 수 있음

변수 %var%

나타나는 곳에서 치환되는 재사용 가능한 변수를 정의합니다.

#set %VARIABLE_NAME% = value or spintax structure

예제

#set %name% = John
#set %greeting% = {Hello|Hi|Hey}
#set %items% = [<minsize=2;maxsize=3;sep=", ";lastsep=" and "> apples|oranges|bananas]
Some text with %name% and %greeting%, also %items%.

변수 규칙

• #set은 줄의 시작에 와야 합니다
• 변수 이름은 %로 감쌈: %name%
• 변수 이름은 영숫자 + 밑줄
• 값에는 모든 spintax 구문 포함 가능 (열거, 순열, 다른 변수)
• 변수는 정의 시가 아닌 참조 시에 확장 (지연 평가)
• #set 줄은 출력에서 제거

WordPress 플러그인의 변수 스코프

플러그인은 세 가지 변수 스코프를 지원합니다. 같은 이름이 여러 스코프에 존재할 때, 가장 강한 스코프가 우선합니다:

1. 런타임 변수 (가장 강함) — 쇼트코드로 전달: [spintax slug="greeting" name="Alice"]
2. 로컬 변수 — 템플릿 내에서 #set으로 정의
3. 글로벌 변수 (가장 약함) — 설정 페이지에서 정의

인클루드 #include

디렉티브 위치에 다른 템플릿을 삽입합니다.

#include "hero-text"

인클루드 규칙

• 템플릿 참조는 큰따옴표로 감쌈
• 템플릿 슬러그 또는 숫자 ID로 해석
• 포함된 템플릿은 자체 변수와 spintax를 포함할 수 있음
• 재귀적 인클루드 지원
• 순환 참조 감지 및 차단
• 자식 템플릿은 글로벌 및 런타임 변수를 상속하지만 부모의 #set 로컬 변수는 상속하지 않음

주석 /#...#/

주석 마커 사이의 텍스트는 다른 처리 전에 출력에서 제거됩니다.

/#
  This is a comment section.
  It can span multiple lines.
  It won't appear in output.
#/

주석 규칙

• 시작 구분자: /#
• 종료 구분자: #/
• 여러 줄에 걸칠 수 있음
• 중첩 불가
• 다른 처리 전에 제거

중첩

모든 구문 요소는 임의의 깊이로 서로 중첩할 수 있습니다:

{option1|[<, > sub1|sub2|sub3]|option3}

[<minsize=2;maxsize=3;sep=", ";lastsep=" and "> {red|blue} apples|{big|small} oranges|bananas]

#set %var% = {a|[b|c]}

후처리

엔진은 생성 후 자동 텍스트 교정을 적용합니다:

1. URL, 이메일, 도메인, 소수, 약어를 대문자화로부터 보호
2. 중복 공백 및 탭 제거
3. 구두점 앞의 공백 제거 (, . ! ?)
4. 구두점 뒤에 누락된 공백 추가
5. 출력의 첫 글자를 대문자로 (HTML 태그 건너뜀)
6. 문장 끝 구두점 뒤 대문자화
7. 블록 수준 HTML 태그 뒤 대문자화
8. 줄바꿈 뒤 대문자화
9. 보호된 플레이스홀더 복원

구문 요약

구문은 Generating The Web (GTW) 표준과 호환됩니다.