Fast, simple yet powerful JavaScript-driven static site generation.
https://gettriossg.com/docs/v6
Please note that earlier versions are no longer supported.
Please note that beginning with v4.0.0 changelog entries now only list major highlights.
Please see https://github.com/4awpawz/trio/issues?q=is%3Aissue+milestone%3Av6.1.0+is%3Aclosed.
Issue #137: Refactor Trio to use BrowserSync's watcher to watch for changes to the public build folder and to respond to "change" events by reloading the browser.
Issue #138: Auto increment the port number that BrowserSync uses since BrowserSync no longer does so when the default port number (3000) is being used.
Please see https://github.com/4awpawz/trio/issues?q=is%3Aissue+milestone%3Av6.0.4+is%3Aclosed.
Issue #134: Module lib/generator/sassRender.js must call toString() when writing the postcssResult.map to a file.
Issue #136: A circular dependency discovered in lib/utils/getFileModifiedTime.js after upgrading Node to v14 LTs and Trio's dependencies.
Please see https://github.com/4awpawz/trio/issues?q=is%3Aissue+milestone%3Av6.0.3+is%3Aclosed.
Issue #133: File watcher not refreshing the browser when ignored file has been added, changed, and deleted.
Please see https://github.com/4awpawz/trio/issues?q=is%3Aissue+milestone%3Av6.0.2+is%3Aclosed.
Issue #131: lib/generator/copyOtherFiles isn't checking if the source folders exist before copying files to the destination folders.
Please see https://github.com/4awpawz/trio/issues?q=is%3Aissue+milestone%3Av6.0.1+is%3Aclosed.
Issue #127: File watcher (chokidar) should be configured to ignore user defined folders to prevent polluting metadata and unnecessary development builds.
Issue #128: lib/generator/getAssets should be configured to ignore user defined folders to prevent polluting metadata.
Please see https://github.com/4awpawz/trio/issues?q=is%3Aissue+milestone%3Av6.0.0+is%3Aclosed.
Issue #124: Remove cache busting from the release CLI command and create its own CLI command cachebust.
Please see https://github.com/4awpawz/trio/milestone/25?closed=1 for details.
Please see https://github.com/4awpawz/trio/milestone/24?closed=1 for details.
Please see https://github.com/4awpawz/trio/milestone/23?closed=1 for details.
Issue #117: Trio now does a one-off build whenever a file is added to the project and building incrementally.
Please see https://github.com/4awpawz/trio/issues?q=milestone%3Av4.2.0 for details.
Please see https://github.com/4awpawz/trio/issues?q=milestone%3Av4.1.0 for details.
Issue #111: Trio now supports callbacks declared on tags that are replaced by include and fragment content.
Please see https://github.com/4awpawz/trio/issues?q=milestone%3Av4.0.0 for details.
Issue #102: Trio now preserves the relative paths of target child folders when resolving permalinks.
Issue #103: Trio now assigns meaningful default values for all the properties in site metadata and trio.manifest.json.
Issue #106: Trio projects now include a source/lib folder for modules that are required by tag-based callback modules and collection filter modules.
Issue #107: Trio's generated projects now include the empty folders that in previous versions were missing because Git doesn't track empty folders.
Issue: #109: Trio no longer includes the ESLint configuration package @4awpawz/eslint-config-4awpawzconfig in scaffold projects.
- New! Preserved include and fragment target tags.
- New! Auto detection of new version.
For more information regarding this release, please read Trio v3.1.0: Improved Developer Experience
- New! Permalinks.
- New! You now have total control as to how you structure your blogs.
- New! Incremental Build Now Watches trio.json For Changes.
- New! Enhanced Collection Dataset Validation.
- Improved Consistent Formating For Error And Warning Messages.
-
Fixed #98 that prevented you from creating a new project at the command line from within the new project's target folder.
-
Fixed #94 that would cause incremental build with watch to break when you would rename a fragment. Now, when you rename a fragment, Trio will run a one-off build to insure that its cache accurately represents the current state of your project.
-
Fixed #93 that would sometimes prevent articles from being generated if they didn't declare a category in their front matter.
Whenever you upgrade to a new version of Trio, you should always run a one-off build to insure that Trio's cache is updated to its current expectations:
$ trio build | bFor more information regarding this release, please read Trio v3.0.0: Permalinkns And Other Goodies
- Collections!
- Enhancements To The CLI
-
Trio no longer appends "-map" to the output css map file name. This was cruft left over from when Buster was still appending its hash to file names, which it no longer does as it now prepends the file name with the hash.
-
The trio.manifest.json file is no longer compressed.
-
You are no longer required to include the .html file extension in the fragment's front matter template property.
There's a new home page, which more succinctly expresses what Trio is all about, and the documentation has received numerous corrections, and enhancements to make it more accurate and easier to read.
-
Fixed #88 - excerpts in markdown fragments aren't being converted to HTML.
-
Fixed #87 - css source maps are being generated incorrectly.
The schema for the cache has changed for v2.0.0, and is incompatible with prior versions. Therefore, if you are upgrading your projects from v1 to v2, you will have to regenerate your project's cache, which you can do by running the following build command in the terminal:
$ trio build | b- Addresses issue #84, where stats for JSON data files and modules indicate they have dependencies to callbacks even when those callbacks no longer declare them as internal dependencies.
- Trio now provides more information when it is unable to resolve assets. See issue #83 for more information.
- Addresses issue #82, where integrity checking and dependency resolution failed to account for templates having indirect references to includes, which caused builds to fail during page generation because of missing include files.
This marks the first stable release of v1.0.0. I'm so excited and I hope you all are too.
- Project scaffolding (issue #80) is now supported as an option (i.e.
-s|--scaffold) when creating a new project from the command line (e.g.$ trio new -s path/to/new/project).
- Addresses issue #79 which formalizes blog archive pages into the project just like blog tag and blog category pages are.
- Addresses issue #81 which would cause destination paths for blog subsidiary pages and archive pages to be generated incorrectly.
- For callbacks that throw exceptions, Trio would catch the exceptions and print just their message to the console, leaving it up to the user to determine which module actually threw the exception. Now, when callbacks throw exceptions, Trio will also print their module names along with their messages to the console.
-
Breaking Change - Fragment properties
destPath(the generated page's target file path) andurl(the generated page's URL) are now generated in all lowercase. -
Breaking Change - Trio no longer generates a unique
idproperty for fragments due to the expense in terms of the development time required to maintain their integrity during incremental builds. In its place, users should now use the fragment'surlproperty, which is intrinsically always unique. -
Breaking Change - Callback argument
$has been renamed to$pagefor clarity and consistency.
- Addresses issue #74 which would cause garbage collection to fail to identify the original blog article to delete when the user changes the blog article's category.
- Addresses issue #73 which would cause dependency resolution to fail if tag-based callbacks are declared with their
.jsfile extensions.
- Addresses issue #72 which would cause include assets with
.htmlfile extension to be wrongly interpreted as markdown files.
This marks the first release candidate for Trio v1. The journey from v0.0.6, which served as a solid proof of concept, to now, has been a long and sometimes difficult one, but in the end I can truly say that it has been a labor of love. I hope you all enjoy it.
-
Integrity Checking checks your project's chains of dependencies and notifies you when assets can't be resolved.
-
Incremental Build reduces project build times by limiting processing to only stale assets.
-
Tag-Based JavaScript Callbacks replace the template engines and frameworks that other static site generators require you to use to extend your composites.
- Addresses issue #59 which would cause etc folder processing to ignore dot files.
- Addresses issue #58 which would raise an exception when generating the public destination paths for category pages.
- Addresses issue #57 which adds the
source/etcfolder to generated projects and whose files are copied as is to the root of the public folder for both dev and release builds. This folder is intended to be used for files likefavicon.ico, robots.txt, sitemaps, .nojekyll, .etcwhich need to reside in the public folder.
- Addresses issue #56 which adds a new configuration option,
"nojekyll", which when set totrueinstructs Trio to write a.nojekyllfile to the public folder when generating a release build to completely bypass Jekyll processing on GitHub Pages.
-
Addresses issue #55 which would cause the generation of inaccurate public paths for blog articles that have nested categories.
-
Addresses issue #54 which would cause the generation of inaccurate public paths for blog articles that have complex names.
Code and documentation Copyright ©2018-2021 Jeffrey Schwartz All Rights Reserved