Are you looking for the latest documentation?

Documentation for Acquia Cohesion V6.0 onwards has moved to https://cohesiondocs.acquia.com

    Step 4. Create your first template and page

    This guide walks through creating your first templates and page. You must have already completed step 1, step 2 and step 3.

    Create a master template

    1. Navigate to DX8 > Templates > Master templates
    2. Click Create next to Master template

      Create-master-template.png
    3. On the next screen, on the Layout canvas, click the + button and drag the Region element onto the Layout canvas

      Add-region-to-layout-canvas-v5-update.gif
    4. Click the ... ellipsis button on the Region element and click Edit in the menu
    5. In the Sidebar editor, click the Theme dropdown and select DX8 minimal theme
    6. Then click on the Region drop-down and select Content
    7. Click Apply at the bottom right of the Sidebar editor
    8. Click Save and continue at the bottom of the page.

      Select-content-region-v5.gif

    Add the layout canvas field to your basic page content type

    1. Navigate to Structure > Content types > Basic page > Manage fields
    2. Click Add field
    3. In the Add new field drop-down, scroll to the Reference revisions section and choose Layout canvas
    4. In the Label field, enter the label Layout canvas
    5. Click Save and continue
    6. Leave the Limit to 1 and click Save and continue again
    7. Click Save settings on the final screen.

      Select-layout-canvas-field.png

    Create a content template for your basic page

    1. Navigate to DX8 > Templates > Content templates > Content type
    2. Click on Basic page
    3. Next to Full (Node, Basic page) click Create


      Create-page-template.png
       
    4. On the next screen, in the Master template drop-down, select Master template
    5. At the bottom of the screen, tick Set as default


      Select-master-and-set-as-default.png
       
    6. Click the + button on the Layout canvas and drag the Field element onto the Layout canvas

      Add-Drupal-field-to-template-v5.gif
       
    7. Click the ...ellipsis button on the Field element and click Edit in the menu
    8. In the Sidebar editor, click the Drupal field drop-down and select Layout canvas
    9. Click Apply at the bottom of the Sidebar editor
    10. Click Save and continue to save your template.

      Select-layout-canvas-field-v5.gif

    Create your first page

    Now that you've added the Layout canvas to your Basic page content type and created a template you should test it to make sure it works as expected.

    1. Navigate to Content > Add content and click Basic page
    2. Give your page a the title Test page (or something similar)
    3. You should see the Layout canvas on the edit screen. If not, repeat Step 2
    4. Click the + button and drag the Paragraph element onto the Layout canvas

      Add-paragraph-to-page-v5.gif
       
    5. On the Paragraph element click the ...ellipsis button and click Edit in the menu
    6. Enter some text in the Paragraph field and click Apply at the bottom of the Sidebar editor
    7. Click Save and publish.
    8. You should now see your page


      Edit-paragraph-preview-page-v5.gif

    That's it, you've created your first DX8 template and page

    If you've followed the above steps correctly and view your test page you will see the paragraph of text you've just added.

    Although this is very basic, you're now able to set-up a new website to use DX8 for creating content templates and page layouts. You can use the rest of this documentation to learn how to create a full website.

    Troubleshooting

    If you view your test page and you don't see the paragraph of text you added then:

    1. Go through each of the steps above to make sure you have followed each one accurately
    2. Clear your browser cache by doing a hard reload on your browser
    3. You can also try clearing the Drupal cache (although you shouldn't need to do this). Navigate to the Drupal 8 menu and click Flush all caches

    Common questions and answers

    1. Why is there a heading title at the top of the page? There's a title on the page because the Content region has the title block in it. To remove this, navigate to Structure > Block layout and scroll to the Content region. Within this you will see a block called Page title. Drag this into the 'DX8 hidden region' and click 'Save'. The title will now be removed from your template and page.

    2. Why does it say Layout canvas above the paragraph? There's a field label above your paragraph because Drupal adds this when you add a field to something. To remove this label, navigate to Structure > Content types > Basic page > Manage display. Then in the Label column, click on the drop-down next to Layout canvas and select 'Hidden'. The label will now be removed from your template and page.

    3. Why is my page is all black with dark grey text? You've not set the DX8 minimal theme as the default so your website is still showing styles from Bartik (Drupal default theme). Navigate to 'Appearance' and click 'Set as default' next to DX8 minimal theme.

    DX8 knowledge base icon

    Frequently asked questions

    Get instant answers to common questions. Available online 24/7.

    Find answers

    Raise a ticket icon

    Raise a support ticket

    To raise a ticket, sign into Acquia Cloud and select Help in the top menu.

    Raise support ticket

    Acquia

    Copyright © 2020 Acquia, Inc. All Rights Reserved. Drupal is a registered trademark of Dries Buytaert.