.. include:: /shortcuts.rstext .. index:: single: Content; Journal single: Enable multiple journals single: Unpublish a journal entry per the "Unpublish" button .. _journal: Journal ---------- *Content → Journal* The *Journal* is a tool with which you can record your thoughts and experiences online. By adding your journal or individual posts of it to a page you can allow other users to place feedback and comments on it. Thus, you can create a dialogue with your audience. Per default, every user has one journal available. You can also have :ref:`multiple journals `. .. figure:: /images/journal_overview.* :alt: Overview of a journal with journal entries Overview of a journal with journal entries #. Journal title #. Journal description (optional) #. Click the *New entry* button to create a new entry in this journal. #. Click the *Settings* button to change certain journal settings (see below). #. Title of the journal entry #. Beginning of the journal entry #. Creation date of the journal entry #. If a journal entry is labeled *Draft*, only you can view it. You can then click the *Publish* button to publish this entry to your journal for others to see when it is included in a page. #. If a journal entry is labeled *Published*, you can click the *Unpublish* button to revert it back to draft status. #. Click the *Edit* button |edit| to make changes to your journal entry. #. Click the *Delete* button |delete| to delete your journal entry. .. index:: single: Journal; Settings single: New in Mahara 1.7; License metadata: Add license information to a journal Change your journal settings ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can change the title of your default journal (and all others if you have enabled multiple journals) and add a description as well as tags. .. figure:: /images/journal_settings.* :alt: Journal settings Journal settings #. Click on the *Settings* button of your journal. #. **Title**: Change the title of your journal. This is a mandatory field. #. **Description**: Add a description for your journal. You can format it as you wish. #. **Tags**: Add tags to your journal for easier searching later on. Separate each tag with a comma. You may also choose tags from the ones that you have created previously by clicking on *Show my tags* and then clicking on the tags you want to use. #. |new in Mahara 1.7| **License**: You see this field if the site administrator turned on :ref:`license metadata `. Choose the license for the journal. You can set your default license in your :ref:`account settings `. #. |new in Mahara 1.7| **Advanced licensing**: You see this option if the site administrator turned on :ref:`license metadata `. If you click it, you see two additional license fields, "Licensor" and "Original URL", that you can fill in if this in not your own journal. #. Click the *Save settings* button to save your changes or the *Cancel* button to abort your changes. .. index:: single: Journal; Add journal entry single: New in Mahara 1.7; License metadata: Add license information to a journal entry .. _add_journal_entry: Add a journal entry ~~~~~~~~~~~~~~~~~~~~~~ All journal entries you make are private to you until you put them into a page. Thus, the publishing of a journal / journal entry is a three-step process: #. You write your entry and save it. #. In a page, you choose one of the :ref:`journal blocks ` that suits your purpose best. #. You give those who shall see that page access to it. Post your journal entry by following the steps below. .. figure:: /images/journal_entry.* :alt: Journal entry Journal entry #. In your journal, click on *New entry*. #. **Title**: Provide a title for your journal entry that expresses what you are writing about. This field is mandatory. #. **Entry**: You must also write some text, add pictures etc. The visual editor helps you format your journal entry. This field is mandatory. #. **Tags**: Add tags to your journal for easier searching later on. Separate each tag with a comma. You may also choose tags from the ones that you have created previously by clicking on *Show my tags* and then clicking on the tags you want to use. #. |new in Mahara 1.7| **License**: You see this field if the site administrator turned on :ref:`license metadata `. Choose the license for the journal entry. You can set your default license in your :ref:`account settings `. #. |new in Mahara 1.7| **Advanced licensing**: You see this option if the site administrator turned on :ref:`license metadata `. If you click it, you see two additional license fields, "Licensor" and "Original URL", that you can fill in if this in not your own journal entry. #. **Attachments**: Add an attachment or more to your journal entry, e.g. PDF files associated with it or images. You can add files either from your :ref:`files area ` or upload new ones directly onto your journal entry. #. **Draft**: Mark your entry as draft if you have not finished it yet. This is especially helpful if you have published your journal in a page, but do not want anybody to read this particular entry (yet). It is always visible to you, but not others. #. **Allow comments**: Check this box if you want to receive comments on the journal entry. #. Click the *Save* button to save your entry or the *Cancel* button to abort your changes. .. index:: single: Journal; Add attachment .. _journal_attachment: Add a file as attachment to a journal entry ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you attach files directly to a journal entry, others can see them whenever they have access to the journal entry. .. figure:: /images/journal_attachment.* :alt: Options on the file attachment screen Attachments for journal entries #. Click the *Add a file* button and then the *Select* button to select the file(s) from your *Files* area that you wish to attach. Alternatively, you can upload additional files directly. #. |new in Mahara 1.7| **License**: You see this field if the site administrator turned on :ref:`license metadata `. Choose the license for the artefact that you are uploading. You can set your default license in your :ref:`account settings `. #. |new in Mahara 1.7| **Licensor**: You see this field if the site administrator turned on :ref:`license metadata `. If you are uploading a file that somebody else created, you can attribut the work to them here and provide their name for example. #. |new in Mahara 1.7| **Original URL**: You see this field if the site administrator turned on :ref:`license metadata `. If you are uploading somebody else's file, provide a link to the original Internet address so that others can go there and view the original file. #. Click the *Browse* button to select a file from your computer to upload. #. If you wish, you can have your uploaded images resized automatically if they are larger than the recommended size. You can only see this option if the site administrator :ref:`made the image resizing option available `. #. If you attached a file that you do not wish to attach anymore, you can click on the *Remove* button to take it off your list of attachments. #. Once you are done, you can click the *Close* button. Add an image to a journal entry ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can add images to your journal entry in two ways: #. Link to the image that is available elsewhere online. #. Use an image that you have on Mahara. .. index:: single: Journal; Link image Link to an image online ^^^^^^^^^^^^^^^^^^^^^^^^ Images that are freely accessible online are easy to add to a journal entry. However, make sure that you have the permission to use this image in your portfolio. .. figure:: /images/tinymce_insert_image_external.* :alt: Insert an external image into a journal post Link an external image in a journal post #. Go to the visual editor and click on the *Image* button |tinymce_image|. #. **Image URL**: Paste or type the image URL into this field. It must start with *http://* or *https://*. #. **Description**: Provide a brief description for your image. #. **Alignment**: Select the alignment of the image in relation to the text. #. **Dimensions**: Change the size of your image. If the image is recognised correctly, you have the image's dimensions displayed. #. **Border**: Add a simple black border to your image if you wish to do so. #. **Vertical / Horizontal space**: Add more space around the image by adding a number in *Vertical space* and / or *Horizontal space*. #. Click the *Insert* button. Alternatively, click the *Cancel* button if you want to abort inserting the image. .. note:: The dimensions are given in pixel. The first value is for the width and the second one for the height. Only change one of the dimensions and delete the value from the second to retain the original proportions of the image. If you are not happy with how the image looks in your journal entry, select it (it will get little square handles) and click on the *Image* button |tinymce_image| again to make adjustments. .. index:: single: Journal; Add image from Mahara Add an image from Mahara ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. figure:: /images/tinymce_insert_image_internal.* :alt: Insert an image that you had attached into a journal post Link an external image in a journal post #. Go to the visual editor and click on the *Image* button |tinymce_image|. #. **Attached image**: Select the image that you wish to display. You must have had it :ref:`attached to the journal entry ` in order to see it here. #. **Description**: Provide a brief description for your image. #. **Alignment**: Select the alignment of the image in relation to the text. #. **Dimensions**: Change the size of your image. If the image is recognised correctly, you have the image's dimensions displayed. #. **Border**: Add a simple black border to your image if you wish to do so. #. **Vertical / Horizontal space**: Add more space around the image by adding a number in *Vertical space* and / or *Horizontal space*. #. Click the *Insert* button. Alternatively, click the *Cancel* button if you want to abort inserting the image. If you are not happy with the alignment or the dimensions of the image in your journal entry, select it and click on the *Image* button |tinymce_image| again to make adjustments. .. index:: single: Journal; Multiple journals .. _multiple_journals: Work with multiple journals ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ *Content → Journals* If you wish to use more journals, e.g. to put your writing into categories for making all posts from one category available in a page without having to select each journal entry, you can go to your :ref:`Settings ` and tick the checkbox *Multiple journals*. .. figure:: /images/journals.* :alt: Multiple journals enabled Multiple journals enabled #. Once you can create multiple journals, click the *Create journal* button to set up a new journal. #. All your journals are listed on *Content → Journals* with their titles and descriptions. The titles link through to the individual journals. #. You see how many entries you have in each journal. #. Click the *New entry* button to create a new journal entry directly from this screen. #. Click the *Settings* button |manage| to make changes to your journal title, description or tags. #. Click the *Delete* button |delete| to delete the journal and all its entries. .. warning:: There is no deletion confirmation message. Once you deleted a journal, the journal as well as all its entries are gone permanently.