#lang racket/base (require (for-syntax racket/base racket/syntax) racket/runtime-path) (define-syntax-rule (define+provide ID EXPR ...) (begin (provide ID) (define ID EXPR ...))) (define+provide current-project-root (make-parameter (current-directory))) (define+provide default-directory-require "pollen.rkt") (define+provide default-env-name "POLLEN") (define (dirname path) (let-values ([(dir name dir?) (split-path path)]) dir)) (define (get-path-to-override maybe-dir) (define starting-dir (cond [(not maybe-dir) (current-directory)] [(directory-exists? maybe-dir) maybe-dir] [else (dirname maybe-dir)])) (let loop ([dir starting-dir][path default-directory-require]) (and dir ; dir is #f when it hits the top of the filesystem (let ([simplified-path (simplify-path (path->complete-path path starting-dir))]) (if (file-exists? simplified-path) simplified-path (loop (dirname dir) (build-path 'up path))))))) ;; parameters should not be made settable. (define-for-syntax world-submodule-name 'setup) (define-syntax (define-settable stx) (syntax-case stx () [(_ NAME DEFAULT-VALUE) (with-syntax ([DEFAULT-NAME (format-id stx "default-~a" #'NAME)] [NAME-THUNKED (format-id stx "~a" #'NAME)] [WORLD-SUBMOD (format-id stx "~a" world-submodule-name)] [NAME-FAIL-THUNKED (format-id stx "fail-thunk-~a" #'NAME)] ) #'(begin (provide (prefix-out setup: NAME-THUNKED) DEFAULT-NAME) (define DEFAULT-NAME DEFAULT-VALUE) ;; can take a dir argument that sets start point for (get-path-to-override) search. (define (NAME-THUNKED [dir #false]) (with-handlers ([exn:fail? (λ (exn) DEFAULT-NAME)]) (dynamic-require `(submod ,(get-path-to-override dir) WORLD-SUBMOD) 'NAME (λ () DEFAULT-NAME))))))])) (define-syntax (define-nonsettable stx) (syntax-case stx () [(_ NAME DEFAULT-VALUE) (with-syntax ([DEFAULT-NAME (format-id stx "default-~a" #'NAME)] [NAME-THUNKED (format-id stx "~a" #'NAME)] [NAME-FAIL-THUNKED (format-id stx "fail-thunk-~a" #'NAME)] ) #'(begin (provide (prefix-out setup: NAME-THUNKED) DEFAULT-NAME) (define DEFAULT-NAME DEFAULT-VALUE) ;; can take a dir argument that sets start point for (get-path-to-override) search. (define (NAME-THUNKED [dir #false]) DEFAULT-VALUE)))])) (define-settable cache-watchlist null) (define-settable envvar-watchlist null) (define-nonsettable preproc-source-ext 'pp) (define-nonsettable markup-source-ext 'pm) (define-nonsettable markdown-source-ext 'pmd) (define-nonsettable null-source-ext 'p) (define-nonsettable pagetree-source-ext 'ptree) (define-nonsettable template-source-ext 'pt) (define-nonsettable scribble-source-ext 'scrbl) ;; these are deliberately not settable because they're just internal signalers, no effect on external interface (define+provide default-mode-auto 'auto) (define+provide default-mode-preproc 'pre) (define+provide default-mode-markup 'markup) (define+provide default-mode-markdown 'markdown) (define+provide default-mode-pagetree 'ptree) (define+provide default-mode-template 'template) (define-nonsettable old-cache-names '("pollen.cache" "pollen-cache")) (define-nonsettable cache-dir-name "compiled") (define-nonsettable cache-subdir-name "pollen") (define+provide default-cache-names (list* (cache-dir-name) (old-cache-names))) (define-settable decodable-extensions (list (markup-source-ext) (pagetree-source-ext))) (define-settable main-pagetree (format "index.~a" (pagetree-source-ext))) (define-settable pagetree-root-node 'pagetree-root) (define-settable main-root-node 'root) (define-settable command-char #\◊) (define-settable template-command-char #\∂) (define-nonsettable template-prefix "template") (define-nonsettable fallback-template-prefix "fallback") (define-nonsettable template-meta-key "template") (define-nonsettable main-export 'doc) ; don't forget to change fallback template too (define-nonsettable meta-export 'metas) (define-nonsettable meta-tag-name 'meta) (define-nonsettable define-meta-name 'define-meta) ;; tags from https://developer.mozilla.org/en-US/docs/Web/HTML/Block-level_elements (define-settable block-tags (cons (main-root-node) '(address article aside blockquote body canvas dd div dl fieldset figcaption figure footer form h1 h2 h3 h4 h5 h6 header hgroup hr li main nav noscript ol output p pre section table tfoot ul video))) (define-settable newline "\n") (define-settable linebreak-separator (newline)) (define-settable paragraph-separator "\n\n") (define-settable paths-excluded-from-dashboard (map string->path (list "poldash.css" "compiled"))) (define-settable project-server-port 8080) (define+provide current-server-port (make-parameter (project-server-port))) (define+provide current-server-listen-ip (make-parameter #f)) (define+provide current-render-source (make-parameter #f)) ;; used to distinguish one-shot rendering (e.g., using `raco pollen setup` or `render` ;; from an interactive session with the project server (using `raco pollen start`) ;; in one-shot mode, certain features needed for dynamic recompilation are disabled for speed. (define+provide current-session-interactive? (make-parameter #false)) (define-settable dashboard-css "poldash.css") (define-runtime-path server-extras-dir "private/server-extras") (define+provide current-server-extras-path (make-parameter server-extras-dir)) (define-settable publish-directory "publish") (define-settable extension-escape-char #\_) (define-settable compile-cache-active #t) (define-settable render-cache-active #t) (define-settable compile-cache-max-size (* 10 1024 1024)) ; = 10 megabytes (define-settable unpublished-path? (λ (path) #f)) ; deprecated in favor of `omitted-path?` (define-settable omitted-path? (λ (path) #f)) (define-settable extra-published-path? (λ (path) #f)) ; deprecated in favor of `extra-path?` (define-settable extra-path? (λ (path) #f)) (define-settable trim-whitespace? #t) (define-settable here-path-key 'here-path) (define-settable splicing-tag '@) (define-settable poly-source-ext 'poly) ; extension that signals source can be used for multiple output targets (define-settable poly-targets '(html)) ; current target applied to multi-output source files (define+provide current-poly-target (make-parameter (car (poly-targets)))) (define-settable index-pages '("index.html")) (define-settable allow-unbound-ids? #true)