.. include:: /shortcuts.rstext .. index:: single: Page; Page editor .. _page_editor: Page editor --------------- The *page editor* is important in Mahara because it allows you to compose your portfolio pages. It consists of a large number of components: #. Editor navigation #. Artefact chooser #. Page layout area .. index:: single: Page editor; Editor navigation Editor navigation ~~~~~~~~~~~~~~~~~~~ .. figure:: /images/page_editor/navigation.* :alt: Page editor navigation Page editor navigation bar * **Edit title and description**: Add and modify your page title, description and tags. * **Edit layout**: Change the overall layout of your page. * **Edit content**: Place your content on a page. See :ref:`artefact chooser `, :ref:`individual artefact blocks ` and :ref:`page layout area `. * **Display page**: Preview your page to see how others, who have access to it, would see it. * **Share page**: Decide who shall have access to your page. See :ref:`"Shared by me" ` for more details. .. index:: single: Page editor; Edit title and description Edit title and description ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You should give your portfolio page a unique title so that you can find it again later on. The description helps you to see quickly on the overview page why you have created this page. Furthermore, the tags help you to search your portfolio for these keywords and find your content and portfolio pages. .. figure:: /images/page_editor/title_description.* :alt: Title and description screen Provide as much information as possible to distinguish and to be able to search your portfolio later on. You can make changes to these settings at any time. #. **Page title**: You must provide a title for your page. Automatically, every page is called "Untitled". #. **Page description**: You can write a brief description for your page, e.g. its purpose. This description is displayed on the overview page and on the portfolio page itself. #. **Tags**: If you have already tagged artefacts or other portfolio pages, you can choose from your existing tags. This makes it easy to avoid spelling mistakes. #. If you either do not yet have tags or want to use new ones, you can write them into the text box. Separate multiple tags by commas (and a space). Tags that you have chosen from your existing list of tags are listed in this text box as well when you have clicked on them. #. **Name display format**: You must choose which name should be displayed when somebody else views your portfolio. You can choose between: * First name * Last name * Full name (first and last name) * Display name #. Click the *Save* button to save your changes. .. index:: single: Page editor; Edit layout .. _edit_layout: Edit layout ~~~~~~~~~~~~~~~~~~~ You have 10 choices for your column layout from 1 column to 5 columns. The 2-, 3- and 4-column layout options allow you to make certain columns wider than others. The icons assist you in your decision of what the end result looks like. However, you cannot set a specific width of a column. .. note:: Be careful when choosing 4 or more columns. Your portfolio page may look very good on your big 21" screen, but a user looking at it on a notebook or tablet may not have the same experience. In most cases, up to 3 columns is the best choice. Click the radio button above the layout that you wish to apply to your page. You can change it at any time. When you reduce the number of columns, your blocks simply move to the first column. You can then move them around to their correct position (see :ref:`page layout area `). .. figure:: /images/page_editor/layout.* :alt: Overall page layout editor Edit the overall layout of a page by choosing the number of columns .. note:: You can add or remove columns directly in the page layout area when you enable the *Show controls to add and remove columns when editing a page* setting in your :ref:`account options `. .. figure:: /images/page_editor/add_remove.* :alt: Add and remove buttons in the page layout area You can use the *Add* and *Remove* buttons for quick changes to the layout when you have enabled them. .. index:: single: Page editor; Artefact chooser .. _artefact_chooser: Artefact chooser ~~~~~~~~~~~~~~~~~~ All different types of artefacts as well as blocks that pull in external content into a portfolio page are accessible via the *artefact chooser*. .. figure:: /images/page_editor/artefact_chooser.* :alt: Artefact chooser All artefacts are accessible via a number of tabs in the page editor * **Files, images and video**: holds blocks for files that can be displayed as links, in folders or in the case of images and videos directly in the page * **Journals**: various artefact blocks which allow you to place journals / journal entries into a page * **General**: artefacts that are of a general nature * **Profile**: choose profile information to display in a block * **Résumé**: display your entire résumé or parts of it * **External content**: contains blocks to place RSS feeds, external media or GoogleApps documents etc. into a page .. seealso:: The functionality of each block that you can use in your portfolio pages and in group pages is outlined in the section on the :ref:`individual artefact blocks `. .. index:: single: Page editor; Page layout area .. _page_layout_area: Page layout area ~~~~~~~~~~~~~~~~~~ The *page layout area* is the place where you arrange all your artefacts for display in a portfolio page. You should know the following about this area: * All artefacts are placed into it by dragging and dropping their blocks into this space. * The artefacts are arranged as a series of continuous blocks per column. * There are no rows, only columns. Blocks are placed beneath each other within a column, but they do not align with blocks in another column to form a single row unless they have the same height. * You can drag and drop blocks by clicking on their headings. * You can change the settings of a block by clicking on its *Configure* button |manage|. .. figure:: /images/page_editor/page_layout_area.* :alt: Drag a block into the page layout area Drag a block into the page layout area and configure its settings #. Click on the block of the artefact that you want to include in your page and drag it into the page layout area. #. When you see the dotted rectangle, drop the block into it to put it onto your page. #. Follow the on-screen instructions on choosing the specific artefact you wish to display. Please refer to the :ref:`artefact block section ` for more information on each block's settings. .. seealso:: Please refer to the section :ref:`edit layout ` to learn how to change the number of columns on a page and make certain columns wider than others. .. index:: single: Page editor; Theme chooser Optional theme chooser ~~~~~~~~~~~~~~~~~~~~~~~~~ You may be able to choose a theme for your portfolio page. If that is the case, you see a *Theme* drop-down menu below the *artefact chooser*. That allows you to select a theme in which that page is displayed to others who view your portfolio page. If the option "Not theme selected" is displayed, the default theme is applied automatically. .. figure:: /images/page_editor/theme_chooser.* :alt: Select a theme for your page Select a theme for your page .. seealso:: The site administrator must allow page themes in the site's :ref:`user settings `.