The 5.7 branch of Magnolia reached End-of-Life on December 31, 2023, as specified in our End-of-life policy. This means the 5.7 branch is no longer maintained or supported. Please upgrade to the latest Magnolia release. By upgrading, you will get the latest release of Magnolia featuring significant improvements to the author and developer experience. For a successful upgrade, please consult our Magnolia 6.2 documentation. If you need help, please contact info@magnolia-cms.com.

In this tutorial:

In this tutorial you create a website with Magnolia. You learn how to create templates and how to display content from a content app. You can use front-end developer tools; no need for Java. We assume that you know the basics of Magnolia which are explained in Hello Magnolia.

Scenario

Eric loves cars. He can't afford a big collection of real cars but besides having a Citroën 2CV he collects car photos and trivia about classic cars. Eric wants to create a website to share his interest.

Getting the files

In this tutorial you need to create some files. The files are available for download but we recommend that you create them by hand – it's a better way to learn. But download them anyway. It helps to have a complete version to look up when required.

Option 1: Git clone

Clone the project if you are familiar with Git. Use a terminal, go to a directory of your choice, and clone:

git clone https://git.magnolia-cms.com/scm/documentation/my-first-website-tutorial.git

Option 2: Download zip files

The following pages explain what the zip files are used for.


Next: Installing Magnolia and a content app

8 Comments

  1. Brice Nzuakue

    Hi,

    I completed this tutorial till "Using site definition" and published the page. But when I call the page from the public instance http://domain/magnoliaPublic/erics-cars.html I got following error:

    Here is the error - copied to paste.bin: https://pastebin.com/6GL6hLtE

    (I have edited this comment.
    Please do not paste huge error stack trace here - but rather provide a link to a file which contains the error message or a fragment from the log-file

    Christoph Meier ).

    1. Christoph Meier

      Brice Nzuakue - I will fix  the tutorial now. While doing it, access to the pages will be restricted. I hope to finish it quickly.

      Cheers, 
       Christoph

    2. Christoph Meier

      Brice Nzuakue 

      F.Y.I. - the tutorial is fixed now for Magnolia 5.7. It works again.

      Sorry for the inconvenience.

      Kind regards, 
       Christoph

  2. Brice Nzuakue

    Christoph Meier still get the same problem.

    1. Christoph Meier

      I went through the adapted tutorial a few times. Successfully. 
      Please note that there are some changes! Check the this commit to get an overview of what has changed.
      => https://git.magnolia-cms.com/projects/DOCUMENTATION/repos/my-first-website-tutorial/commits/5f1d141d055fd6232e5f4ea50a7c101bfea98c45#light-modules/one-pager-module/dialogs/components/content-items-list.yaml

  3. Brice Nzuakue

    I already made that change yesterday but still getting the problem. How can I send you my whole files? Maybe that would be hepful.

    1. Christoph Meier

      I will not parse all your files.

      Try this: If you have created the includable fragment after the creation of the file which does include it, save the latter again to force the YAML parser to properly register the dialog definition. 

      And what always is a good advice: Open the Definitions app, have a look at the Problems subapp.

  4. Training Participants - FullStack Developer

    For other guys who will face on this problem, you need to copy magnolia-app-tutorial-1.4.8.jar file to Publish instance too ($<your-magnolia-installation>/apache-tomcat-x.y/webapps/magnoliaPublic/WEB-INF/lib). And also need to update the magnolia.resources.dir config for your Publish instance the same as Author.