Coder Social home page Coder Social logo

jmcouffin / automad Goto Github PK

View Code? Open in Web Editor NEW

This project forked from marcantondahmen/automad

0.0 0.0 0.0 19.42 MB

A flat-file content management system and template engine

Home Page: https://automad.org

License: MIT License

Shell 0.52% JavaScript 0.34% PHP 38.15% TypeScript 44.08% Hack 4.38% Less 12.54%

automad's Introduction

Automad

A flat-file content management system and template engine.

Tag PHP Language Size License Twitter

Screenshot

Links

Live Demo

In case you quickly want to try out Automad without setting up a server first, just check out the live demo for free. There is no sign-up required and you can start exploring new features right in away in your personal demo instance.

Important

Please note that in order to keep hosting costs under control, all demos are running on minimal hardware and expire after one hour.

Installation

Note that this repository only contains source code. Please follow the instructions below in order to install a fully bundled version of Automad using Docker or Composer. It is also possible to manually download and install Automad.

Composer

The fastest way to get Automad up and running is to use Composer.

composer create-project automad/automad . v2.x-dev

Follow this guide to finish the installation and get started quickly.

Docker

It is also possible to run Automad in a Docker container including Nginx and PHP 8.3.

docker run -dp 80:80 -v ./app:/app --name mysite automad/automad:v2

This will essentially make your site available at port 80 and mount a directory called app in the current working directory for data persistence. A new user account for the Automad dashboard will be created automatically. The account details will be logged by the running container. You can show these logs using the following command:

docker logs mysite

Your can now navigate to localhost to view your new site.

Manual Installation

In case you are not able to use Docker or Composer, you can also deploy Automad manually.

  1. Download a distribution bundle and move the unpacked content to the document root of your webserver.
  2. Make sure the PHP process has the permissions to write to the document root and its subdirectories including all installed files.
  3. Visit the /dashboard route of your site and create the first user.

Migrating Content

In order to migrate an old Automad installation to the new version 2, please follow the migration giude in the documentation.

Documentation

Take a look at the documentation to get started with Automad.

Packages

Visit the Automad package browser to get free themes and extensions for your Automad site.

Community

Join the community, ask questions or start a discussion on the Automad discussion platform.

Contributing

In case you are interested in contributing, the following types of contribution are welcome:

However, I do not exclude at this point using parts of Automad's source in future projects under different licenses. In order to avoid having to ask anybody for permission when doing so, I will not accept any contributions to this repository. Please understand that pull requests will therefore be ignored.

Text Editors Plugins

To make the development of themes more efficient, plugins providing syntax highlighting and snippets for Automad's template language are available for the following editors:


© 2013-2024 Marc Anton Dahmen
Released under the MIT license

automad's People

Contributors

marcantondahmen avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.