Orion API - 빌드

[초안] Last updated by Joe Schaefer on 토, 13 4월 2024    source
 

이 문서에서는 시스템 구축 API에 대해 다룹니다..


빌드 시스템

SunStarSys::보기.

single_narrative(%args).

필수 인수:

선택적 인수:

news_page(%args).

사이트맵(%args).

종속성의 로케일별 정렬된 인덱스입니다.

필수 인수:

선택적 인수:

asymptote(%args).

빌드 및 캐시 asymptote 삼중 따옴표로 묶인 코드 블록.

필수 인수:

건너뛰기(%args).

Don’이 모든 것을 건설하라. 대신 연관된 생성된 소스 파일(예: .bib\$ 언어 \mapsto \$base.page/bibliography.yml\$lang)는 보조 빌드 시스템 실행에 빌드됩니다.

yml2ext(%args).

YAML 파일을 변환합니다.

선택적 인수:

fetch_deps($path, $data, $quick).

필수 인수:

이동 경로($path).

다음에 대한 HTML 이동 경로 목록을 반환합니다. $경로.

메모화(%args).

빌드를 캐시에 저장합니다. 주로 fetch_deps 및 quick_deps > 2와 함께 사용됩니다.

압축(%args).

사용되지 않습니다.

next_view(%args).

$args 처리를 위한 유틸리티{보기}.

ssi(%args).

반복적으로 평가 ssi 태그

오프라인(%args).

오프라인 모드에서 next_view를 실행합니다.

코드 조각(%args).

코드 조각 라인을 처리합니다.

재구성(%args).

next_view에서 빌드된 콘텐츠의 템플리트 지시어를 재처리합니다.

로컬 링크에서 파일 확장자를 자릅니다.

로컬 링크(./ 및 ../)를 정규화합니다.


SunStarSys::까지.

read_text_file($file, $out, $content_lines).

UTF-8 인코딩 파일의 헤더+내용을 구문 분석합니다. $파일 결과 저장 위치 $out. $content_lines 읽을 콘텐츠 라인의 최대 개수(선택 사항)입니다.
읽은 실제 행 수(머리글 포함)를 반환합니다.

$파일 파일의 전체 내용을 나타내는 원시 문자열에 대한 참조일 수 있습니다. 결과는 $out UTF-8이 인코딩됩니다.

copy_if_newer($src, $dest).

매수 $소스 종료 $일부 이전’수정 시간 기록이 후자보다 최신입니다.’s입니다. 복사본에서 gzip-compresses의 $일부 파일 if it’텍스트 파일로 저장하고 “.gz” 이름을 확장합니다.

get_lock($lockfile).

현재 UNIX 프로세스의 경우 배타적(f)잠금을 $lock파일.

셔플(\@deck).

내장 무작위(어류) 셔플 @deck.

sort_tables($content).

각 테이블에 따라 $content로 매가인하 테이블을 정렬합니다.’s 열 사양 테이블당 정확히 하나의 열을 정렬할 수 있습니다(선택 사항). n개, 내림차순 v 또는 오름차순 ^ 주문.

fixup_code($prefix, $type, @_).

@_의 모든 인수에서 $prefix를 제거합니다. $type 인수의 함수는 구현에 따라 다르지만 주로 editor.md를 시드하는 데 사용됩니다. “모드” @_에서 이 컨텐츠를 처리합니다.

unload_package($pkg).

Perl 패키지를 적극 언로드합니다. $pkg 기호 테이블(STASH)에서

purge_from_inc(@paths).

제거 @paths 시작일 @INC.

터치(@_).

모든 파일을 @_. 인수가 전달되지 않으면 $_.

normalize_svn_path(@_).

의 모든 경로를 정규화합니다. @_ 원시 인수로 안전하게 사용 품질 관리 명령

sanitize_relative_path(@_).

경로 보안 @_ 에서 순수한 상대 경로로 사용 도티악::DTL (장고 템플릿) 경로별 명령.

parse_filename($path).

주변 래퍼 파일::Basename::fileparse. 인수가 없으면 $_ 구문 분석할 파일 이름입니다.

walk_content_tree($code).

조건부로 걷기 ./콘텐츠 빌드 시스템 체크아웃의 트리, 먼저 정규화 $_ 형식 서브 경로로 변경한 다음 $code는 보도의 각 항목에 적용됩니다.

아카이브됨($path).

각 플래그 상태: 아카이브 $경로. 사용 $_ 인수가 전달되지 않은 경우

seed_file_deps($path).

업데이트 %path::종속성 대상 $경로을 기반으로 종속성 헤더 glob(s). 사용 기본값 $_ 인수가 전달되지 않은 경우 경로로 지정됩니다.

seed_file_acl($path).

업데이트 @path::acl 대상 $경로을 기반으로 ACL 헤더 사양 사용 기본값 $_ 인수가 전달되지 않은 경우 경로로 지정됩니다.

로드

같음 YAML::XS:: 짐.

덤프

같음 YAML::XS::덤프.