A wonderful Blog engine built on Umbraco
C# CSS JavaScript HTML ASP PowerShell Other
Latest commit a5ecb96 Sep 15, 2017 @Shazwazza Shazwazza updates readme

README.md

Articulate

A wonderful Blog engine built on Umbraco

Features

Supporting all the features you'd want in a blogging platform

  • Categories & Tags
  • Themes
  • Live Writer support
  • Markdown support
  • Easily post from your mobile phone including adding images and photos direct from you camera
  • Disqus, Google+ or Facebook comment support
  • Search
  • Blogml import/export
  • During import we can also export a compatible XML so you can easily import your comments to Disqus
  • RSS
  • Built in or custom feed
  • Feeds per category/tag
  • Customizable urls
  • Author profiles

Minimum requirements

Articulate version 3+ is only compatible with Umbraco 7.6+

Documentation

Docs on installation, creating posts, customizing/creating themes, etc...

Discussions

Please post to this Umbraco discussions forum to discuss Articulate, it's features and functionality. Do not post issues here, post them here on GitHub

Issues

If you have any issues, please post them here on GitHub

Releases

See here for the list of releases and their release notes

Contributing

If you would like to contribute to the Articulate project, you'll need some info on how to get started with the solution

  1. Clone the repository
  2. Open the /src/Articulate.sln file
  3. Build the solution - this will run a Nuget package restore
  4. Ensure that Articualte.Web is set as the startup project
  5. Start the Articulate.Web project
  6. This will run the Umbraco installer, install as per normal
  7. Open a powershell command line at the /build folder
  8. Execute build.ps1
  9. This will prompt you for a version, enter the latest Articulate version (at the time of writing this is "3.0.0")
  10. It will prompt your for a pre-release value, just press Enter to skip this
  11. Once the build has completed, it will have created the Articulate Umbraco package at /build/Release/Articulate.zip
  12. Install this package in the Umbraco back office

Now you're all set! Any source changes you wish to make just do that in Visual Studio, build the solution when you need to and the changes will be reflected in the website.

Changing Umbraco Articulate schema elements

What I mean by 'schema' elements here are things like Document Types, Property Types, Data Types, etc... If you wish to make changes to these, like adding a property to the Blog Post Document Type, you'll must make this change in the xml file: /buid/packagemanifest.xml

Updating to latest committed changes

If you are developing on this project and someone has made changes to any schema elements and you need to sync your environment to the latest changes, you can now use the Articulate dashboard installer and run the installer. This will essentially re-install the package business logic will will add any missing schema elements that are missing.

If you wish to re-force the package installation, you can remove the Articulate <package> element from the file /App_Data/packages/intalled/installedPackages.config for the current Articulate vesion you are working with. Then you can run the dashboard installer and it will re-sync the data.

Copyright & Licence

© 2017 by Shannon Deminick

This is free software and is licensed under the The MIT License (MIT)