@@ -289,10 +289,10 @@ discard block |
||
289 | 289 | public static function sanitizeKey(string $key): string |
290 | 290 | { |
291 | 291 | $key = str_replace(['https://', 'http://'], '', $key); // remove protocol (if URL) |
292 | - $key = Page::slugify($key); // slugify |
|
293 | - $key = trim($key, '/'); // remove leading/trailing slashes |
|
294 | - $key = str_replace(['\\', '/'], ['-', '-'], $key); // replace slashes by hyphens |
|
295 | - $key = substr($key, 0, 200); // truncate to 200 characters (NTFS filename length limit is 255 characters) |
|
292 | + $key = Page::slugify($key); // slugify |
|
293 | + $key = trim($key, '/'); // remove leading/trailing slashes |
|
294 | + $key = str_replace(['\\', '/'], ['-', '-'], $key); // replace slashes by hyphens |
|
295 | + $key = substr($key, 0, 200); // truncate to 200 characters (NTFS filename length limit is 255 characters) |
|
296 | 296 | |
297 | 297 | return $key; |
298 | 298 | } |
@@ -325,7 +325,7 @@ discard block |
||
325 | 325 | /** |
326 | 326 | * Convert the various expressions of a TTL value into duration in seconds. |
327 | 327 | */ |
328 | - protected function duration(int|\DateInterval $ttl): int |
|
328 | + protected function duration(int | \DateInterval $ttl): int |
|
329 | 329 | { |
330 | 330 | if (\is_int($ttl)) { |
331 | 331 | return $ttl; |
@@ -65,7 +65,7 @@ discard block |
||
65 | 65 | 'metatags' => [ |
66 | 66 | 'robots' => 'index,follow', // SEO robots default directive |
67 | 67 | ], |
68 | - 'pages' => [ // Markdown content management |
|
68 | + 'pages' => [// Markdown content management |
|
69 | 69 | 'dir' => 'pages', // pages files directory |
70 | 70 | 'ext' => ['md', 'markdown', 'mdown', 'mkdn', 'mkd', 'text', 'txt'], // supported files formats, by extension |
71 | 71 | 'exclude' => ['vendor', 'node_modules'], // directories, paths and files name to exclude (accepts globs, strings and regexes) |
@@ -99,12 +99,12 @@ discard block |
||
99 | 99 | 'caption' => false, // puts the image in a <figure> element and adds a <figcaption> containing the title |
100 | 100 | 'placeholder' => '', // fill <img> background before loading (`color` or `lqip`) |
101 | 101 | 'class' => '', // puts default CSS class(es) to each image |
102 | - 'remote' => [ // turns remote images into Assets to process them (disable with `false`) |
|
102 | + 'remote' => [// turns remote images into Assets to process them (disable with `false`) |
|
103 | 103 | 'fallback' => '', // path to the fallback image, stored in assets directory (empty by default) |
104 | 104 | ], |
105 | 105 | ], |
106 | 106 | 'links' => [ |
107 | - 'embed' => [ // turns links in embedded content if possible |
|
107 | + 'embed' => [// turns links in embedded content if possible |
|
108 | 108 | 'enabled' => false, |
109 | 109 | 'video' => ['mp4', 'webm'], // supported video file types, by extension |
110 | 110 | 'audio' => ['mp3', 'ogg', 'wav'], // supported audio file types, by extension |
@@ -125,16 +125,16 @@ discard block |
||
125 | 125 | // <position> => 'Cecil\Generator\<class>', |
126 | 126 | //], |
127 | 127 | ], |
128 | - 'data' => [ // data files |
|
128 | + 'data' => [// data files |
|
129 | 129 | 'dir' => 'data', // data files directory |
130 | 130 | 'ext' => ['yaml', 'yml', 'json', 'xml', 'csv'], // loaded files by extension |
131 | 131 | 'load' => true, // enables `site.data` collection |
132 | 132 | ], |
133 | - 'assets' => [ // assets: CSS, JS, images, etc. |
|
133 | + 'assets' => [// assets: CSS, JS, images, etc. |
|
134 | 134 | 'dir' => 'assets', // assets files directory |
135 | 135 | 'target' => '', // where processed assets are saved (in output directory) |
136 | 136 | 'fingerprint' => true, // enables fingerprinting |
137 | - 'compile' => [ // Sass files compilation |
|
137 | + 'compile' => [// Sass files compilation |
|
138 | 138 | 'style' => 'expanded', // compilation style (`expanded` or `compressed`) |
139 | 139 | 'import' => ['sass', 'scss', 'node_modules'], // list of imported directories |
140 | 140 | 'sourcemap' => false, // enables sourcemap in debug mode |
@@ -145,7 +145,7 @@ discard block |
||
145 | 145 | 'optimize' => false, // enables images optimization with JpegOptim, Optipng, Pngquant 2, SVGO 1, Gifsicle, cwebp, avifenc |
146 | 146 | 'quality' => 75, // image quality after optimization or resize |
147 | 147 | 'formats' => [], // creates and adds formats images as `source` (e.g.: ['webp', 'avif']) |
148 | - 'responsive' => [ // options of generated responsive images |
|
148 | + 'responsive' => [// options of generated responsive images |
|
149 | 149 | 'widths' => [480, 640, 768, 1024, 1366, 1600, 1920], // `srcset` widths |
150 | 150 | 'sizes' => ['default' => '100vw'] // default `sizes` attribute |
151 | 151 | ], |
@@ -159,26 +159,26 @@ discard block |
||
159 | 159 | //] |
160 | 160 | ], |
161 | 161 | ], |
162 | - 'static' => [ // static files |
|
162 | + 'static' => [// static files |
|
163 | 163 | 'dir' => 'static', // static files directory |
164 | 164 | 'target' => '', // subdirectory where files are copied |
165 | 165 | 'exclude' => ['sass', 'scss', '*.scss', 'package*.json', 'node_modules'], // excluded files by extension or pattern |
166 | 166 | 'load' => false, // enables `site.static` collection |
167 | 167 | ], |
168 | - 'layouts' => [ // layouts and templates |
|
168 | + 'layouts' => [// layouts and templates |
|
169 | 169 | 'dir' => 'layouts', // Twig templates directory |
170 | - 'images' => [ // how to handle images in templates |
|
170 | + 'images' => [// how to handle images in templates |
|
171 | 171 | 'formats' => [], // creates and adds formats images as `source` (e.g.: ['webp', 'avif']) |
172 | 172 | 'responsive' => false, // enables responsive images |
173 | 173 | ], |
174 | - 'translations' => [ // i18n |
|
174 | + 'translations' => [// i18n |
|
175 | 175 | 'dir' => 'translations', // translations files directory |
176 | 176 | 'formats' => ['yaml', 'mo'], // translations supported formats |
177 | 177 | ], |
178 | - 'extensions' => [ // list of Twig extensions class |
|
178 | + 'extensions' => [// list of Twig extensions class |
|
179 | 179 | //'<name>' => 'Cecil\Renderer\Extension\<class>', |
180 | 180 | ], |
181 | - 'components' => [ // components |
|
181 | + 'components' => [// components |
|
182 | 182 | 'dir' => 'components', // components directory |
183 | 183 | 'ext' => 'twig', // components files extension |
184 | 184 | ], |
@@ -186,7 +186,7 @@ discard block |
||
186 | 186 | // '<section>' => '<layout>', |
187 | 187 | //] |
188 | 188 | ], |
189 | - 'output' => [ // output formats and post process |
|
189 | + 'output' => [// output formats and post process |
|
190 | 190 | 'dir' => '_site', // output directory |
191 | 191 | //'formats' => [ // https://cecil.app/documentation/configuration/#formats |
192 | 192 | // [ |
@@ -197,7 +197,7 @@ discard block |
||
197 | 197 | // 'exclude' => ['variable1', 'variable2'], |
198 | 198 | // ], |
199 | 199 | //], |
200 | - 'pagetypeformats' => [ // formats applied by page type |
|
200 | + 'pagetypeformats' => [// formats applied by page type |
|
201 | 201 | 'page' => ['html'], |
202 | 202 | 'homepage' => ['html', 'atom'], |
203 | 203 | 'section' => ['html', 'atom'], |
@@ -208,10 +208,10 @@ discard block |
||
208 | 208 | // '<name>' => 'Cecil\Renderer\PostProcessor\<class>', |
209 | 209 | //], |
210 | 210 | ], |
211 | - 'cache' => [ // cache management |
|
211 | + 'cache' => [// cache management |
|
212 | 212 | 'enabled' => true, // disable with `false` |
213 | 213 | 'dir' => '.cache', // cache files root directory |
214 | - 'assets' => [ // assets cache |
|
214 | + 'assets' => [// assets cache |
|
215 | 215 | 'ttl' => null, // assets cache TTL (no expiration by default) |
216 | 216 | 'remote' => [ |
217 | 217 | 'ttl' => 604800, // remote assets cache TTL (7 days by default) |
@@ -220,7 +220,7 @@ discard block |
||
220 | 220 | 'templates' => true, // disable Twig templates cache with `false` |
221 | 221 | 'translations' => true, // disable translations dictionary cache with `false` |
222 | 222 | ], |
223 | - 'optimize' => [ // files optimization |
|
223 | + 'optimize' => [// files optimization |
|
224 | 224 | 'enabled' => false, // enables files optimization |
225 | 225 | 'html' => [ |
226 | 226 | 'enabled' => true, // enables HTML files optimization |
@@ -60,7 +60,7 @@ discard block |
||
60 | 60 | * |
61 | 61 | * @throws RuntimeException |
62 | 62 | */ |
63 | - public function __construct(Builder $builder, string|array $paths, array|null $options = null) |
|
63 | + public function __construct(Builder $builder, string | array $paths, array | null $options = null) |
|
64 | 64 | { |
65 | 65 | $this->builder = $builder; |
66 | 66 | $this->config = $builder->getConfig(); |
@@ -81,20 +81,20 @@ discard block |
||
81 | 81 | } |
82 | 82 | }); |
83 | 83 | $this->data = [ |
84 | - 'file' => '', // absolute file path |
|
85 | - 'files' => [], // array of absolute files path |
|
84 | + 'file' => '', // absolute file path |
|
85 | + 'files' => [], // array of absolute files path |
|
86 | 86 | 'missing' => false, // if file not found but missing allowed: 'missing' is true |
87 | - '_path' => '', // original path |
|
88 | - 'path' => '', // public path |
|
89 | - 'url' => null, // URL if it's a remote file |
|
90 | - 'ext' => '', // file extension |
|
91 | - 'type' => '', // file type (e.g.: image, audio, video, etc.) |
|
92 | - 'subtype' => '', // file media type (e.g.: image/png, audio/mp3, etc.) |
|
93 | - 'size' => 0, // file size (in bytes) |
|
94 | - 'width' => 0, // image width (in pixels) |
|
95 | - 'height' => 0, // image height (in pixels) |
|
96 | - 'exif' => [], // image exif data |
|
97 | - 'content' => '', // file content |
|
87 | + '_path' => '', // original path |
|
88 | + 'path' => '', // public path |
|
89 | + 'url' => null, // URL if it's a remote file |
|
90 | + 'ext' => '', // file extension |
|
91 | + 'type' => '', // file type (e.g.: image, audio, video, etc.) |
|
92 | + 'subtype' => '', // file media type (e.g.: image/png, audio/mp3, etc.) |
|
93 | + 'size' => 0, // file size (in bytes) |
|
94 | + 'width' => 0, // image width (in pixels) |
|
95 | + 'height' => 0, // image height (in pixels) |
|
96 | + 'exif' => [], // image exif data |
|
97 | + 'content' => '', // file content |
|
98 | 98 | ]; |
99 | 99 | |
100 | 100 | // handles options |
@@ -150,7 +150,7 @@ discard block |
||
150 | 150 | $this->options = array_merge([ |
151 | 151 | 'drafts' => false, // if true, build drafts too |
152 | 152 | 'dry-run' => false, // if true, generated files are not saved |
153 | - 'page' => '', // if specified, only this page is processed |
|
153 | + 'page' => '', // if specified, only this page is processed |
|
154 | 154 | ], $options); |
155 | 155 | |
156 | 156 | // set build ID |
@@ -207,7 +207,7 @@ discard block |
||
207 | 207 | /** |
208 | 208 | * Set configuration. |
209 | 209 | */ |
210 | - public function setConfig(array|Config $config): self |
|
210 | + public function setConfig(array | Config $config): self |
|
211 | 211 | { |
212 | 212 | if (\is_array($config)) { |
213 | 213 | $config = new Config($config); |