{"repo":"olssonm/ampersand","free":true,"listed":false,"github":"https://github.com/olssonm/ampersand","clone":"git clone https://github.com/olssonm/ampersand.git","description":"Plug and play flat file markdown blog for your Laravel-projects","language":"PHP","stars":27,"topics":["laravel","blog","markdown","flat-file"],"license":"MIT","category":"productivity","readme_excerpt":"Ampersand Plug-and-play flat file markdown blog tool for your Laravel-project. Create an article or blog-section on your site without the hassle of setting up tables, models or your own flat file-system. Built upon spatie/sheets to handle the markdown-files and YAML-front matter parsing. Note: This package is built for quick and easy setup and use – don't expect a fully featured CMS. 🛠 Install and configure Require package: Publish config-files and views: In config/ampersand.php you can now customize the settings to your liking. Views are available at resources/views/vendor/ampersand ✏️ Writing posts Filename format All posts should be stores in your posts path -directory with the filename format of 2021-03-30.my-post.md , i.e. {date:Y-m-d}.{slug}.md . The slug is what determines at what URL your post will be available at. Artisan command You can quickly create a new post via the artisan command: YAML front matter Posts can contain any number of attributes via YAML-front matter: 🖥 Displaying posts Two views are shipped with this package; an index-view and a show-view (used for single posts). They are located in /resources/vendor/views/ampersand after installation and are fully customizable. In index.blade.php a collection of post-objects is available via the $posts -variable. It behaves much as a standard Eloquent-collection. Pagination-links are also available: The Post-object contains all your front matter attributes as well as slug , date and contents . Retrieve posts in","default_branch":null,"files":null,"tree":[],"storefront":"/r/olssonm","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/olssonm/ampersand/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}