[DOCU-1346] How-to create a site def. "from scratch" Created: 27/Feb/18  Updated: 28/Oct/19  Resolved: 28/Oct/19

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: Task Priority: Neutral
Reporter: Christoph Meier Assignee: Richard Gange
Resolution: Done Votes: 0
Labels: HowTo, tutorial
Remaining Estimate: 0d
Time Spent: 0.25d
Original Estimate: Not Specified

Issue Links:
relation
is related to DOCU-1382 Site app page should show both config... Closed
Template:
Acceptance criteria:
Empty
Task DoR:
Empty
Date of First Response:

 Description   

Root cause

We must emphasize the node structure - which is different for CE vs. EE

Besides that it is a very relevant use case. Where newbs may start with the travel-demo, at some point the must most probably want their own site def. - with EE or CE.
For Multisite we actually have not too bad docs with How to use Multisite.
Now let's have something for just one simple site def. (for CE, EE).

Here is a hipchat comment from amanzoni

We have a prospect, who's using the CE version.
He was trying to set a site definition by reading the documentation. But it seems that all the doc is describing how to do for the Enterprise version only.
Is that wanted ?

He started from that one
https://documentation.magnolia-cms.com/display/DOCS56/Template+prototype
I noticed that for CE, you need to put your nodes directly at the roots
I don't know if it is a bug or if it has changed recently

Tasks

How to create a site definiton from scratch

for both CE and EE version

  • mention the different node structure for with/without multisite
  • explain usage of site app
  • provide a super simple example which works for both (so needs variants, kind of)

Example needs to be further defined!

Add-on: Understanding site example(s) on demo

Note that we also have different examples on CE vs EE when it comes to travel demo (with sportstation on EE)



 Comments   
Comment by Richard Gange [ 28/Oct/19 ]

We must emphasize the node structure - which is different for CE vs. EE

What I have done is added screenshots for both CE and EE to the Site app page. There I also try to make is clear with a couple sentences that the configuration differs slightly.

I point out:

  • How the site definition should be configured for CE.
  • How the site definition should be for EE.
  • In EE each site definition needs a parent node.

Further more, if you go to the download page for community edition you will find there is a travel demo bundle and a travel demo war that can be used to see actual examples.

Generated at Mon Feb 12 01:17:19 CET 2024 using Jira 9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b.