Download the PHP package linkorb/blazon without Composer
On this page you can find all versions of the php package linkorb/blazon. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download linkorb/blazon
More information about linkorb/blazon
Files in linkorb/blazon
Package blazon
Short Description Blazon: publish fast and beautiful websites, campaign sites, documentation, guides etc from data (e.g. Xillion Resources)
License MIT
Homepage http://www.github.com/linkorb/blazon
Informations about the package blazon
blazon
Blazon is a data-driven, plugin-powered, multi-target content publishing framework.
Use-cases:
- Documentation, guides, manuals
- Contracts (with variables)
- Legal documents
- "Conditional text" content
- Wiki content rendering
- Marketing sites
- Policies, Procedures, Forms
- Knowledge graphs
- Digital gardens
- Code repository project documentation
- Complex data graph visualization (i.e. organizational structures)
Definitions:
- Publication: Collection of "documents"
- Document: unique identifier (path), and a controller for rendering output
- Plugin: allows to modify every phase of the loading and publishing process
- Target: one of many outputs, produced by a Publisher (i.e. static html, pdf, etc).
Features:
- Load content from local or remote sources
- Markdown, with frontmatter
- Xillion Resources
- Twig templating
- Supports both static site generation and dynamic rendering
Examples
- https://github.com/linkorb/starwars-blazon graphql + twig example site
Installation
Usage
Your Blazon project (i.e. your site, book, report, etc) should be stored in it's own directory, preferably a Git repository.
From there, use the blazon
cli tool to generate a static HTML site into the build/
directory of your project:
Publishing
This command:
- Builds your Publication in-memory, using your custom
PublicationFactory
, or the default factory. - Loops over all registered
Document
instances - Renders the output of each
Document
using it'shandler
callback, and writes it to the Document'spath
intobuild/
- Recursively copies any public assets (images, css, js, pdfs, etc) from
public/
intobuild/
You can now serve the generated build/
directory as a static (html) site on your favorite service:
- A simple nginx container
- Github pages
- Netlify
- ...etc
Auto-Publishing with "watch-mode"
Pass the -w
flag to the blazon publish
command to tell blazon to keep watching your project's source directory for changes. After any detected change, it will automatically (re)publish to build/
Preview server
Blazon includes a minimal preview server that you can use while authoring content and styling your publication.
Simply point your favorite PHP-enabled webserver (i.e. apache with mod-php, nginx with php-fpm, etc) to blazon's public/
directory.
Make sure to setup SOURCE_PATH=/path/to/your/blazon-project
in Blazon's .env
file.
Features:
- Builds the publication on every HTTP request
- In-memory, no writes to
build/
- Verbose error messages when setting
DEBUG=true
in your.env
file. - Supports serving static assets from your publication's
public/
directory.
It is not recommended to use the preview server in production. Use the blazon publish
command instead for maximum security and performance.
Inspiration
- Gatsby
- Hugo
- Sage
- Xillion
- Schemata
Contributing
We welcome contributions to make this repository even better. Whether it's fixing a bug, adding a feature, or improving documentation, your help is highly appreciated. To get started, fork this repository then clone your fork.
Be sure to familiarize yourself with LinkORB's code of conduct before submitting any changes.
If you are unable to implement changes you like yourself, don't hesitate to open a new issue report so that we or others may take care of it.
Brought to you by the LinkORB Engineering team
Check out our other projects at linkorb.com/engineering.
By the way, we're hiring!
All versions of blazon with dependencies
symfony/console Version ^5.2
symfony/yaml Version ^5.0
twig/twig Version ^1.0
symfony/dotenv Version ^5.0
monolog/monolog Version ^2.3
league/container Version ^4.0
linkorb/xillion Version ^1.8
league/event Version ^3.0
laminas/laminas-diactoros Version ^2.6
guzzlehttp/guzzle Version ^7.4
league/commonmark Version ^2.3