.. index:: Journal .. _journal: 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. .. tip:: If you wish to use more journals, e.g. to put your writing into categories so that you can make all posts from one category available in a page without having to select each journal entry, you can go to your *Settings* and select *Enable multiple journals*. .. index:: pair: Journal; Settings 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. #. Click on the *Settings* button for your journal. #. Change the title. #. Add a description for your journal. You can format it as you wish. #. Add tags to your journal for easier searching later on. Tags that you have already used elsewhere are available to you under *Show my tags*. #. Click *Save Settings*. .. index:: pair: Journal; 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 either the block for making the entire journal visible or just one post from a journal. #. You give those who shall see that page access to it. When you are ready to post your journal entry: #. In your journal, click on *New Entry*. #. Provide a title for your journal entry. #. You must also write something in the *Body*. The visual editor helps you format your journal entry. #. Add tags to your entry to find it more easily later on. You can choose from tags that you have already used and / or enter new ones. Separate each tag with a comma. You may also choose tags from the ones that you have created previously. #. 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 files area or upload new ones directly onto your journal entry. #. Mark your entry as draft if you have not yet finished it. 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 if you want to receive them on the journal entry. #. Save your entry. .. index:: pair: Journal; Add attachment Add a file as attachment to a journal entry ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ #. Click on the *Add a file* button and then *Select* the file(s) from your *Files* area that you wish to attach. #. Alternatively, you can *Upload* additional files. #. If you attached a file that you do not wish to attach anymore, you can *Remove* it. #. Once you are done, you can click the *Close* button. .. figure:: /images/journal_attachment.* :alt: Options on the file attachment screen Attachments for journal entries .. index:: pair: Journal; Add image 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:: pair: 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. #. Go to the visual editor and click on the *Image* button |tinymce_image|. #. Paste or type the image URL into the *Image URL* field. It must start with *http://* or *https://*. #. Provide a brief description for your image. #. Select the alignment to the text for your image. #. Change the dimensions of your image if they are too large. If the image is recognised correctly, you have the image's dimensions displayed. #. Add a border to your image if you wish to do so. #. Add more space around the image by adding a number in *Vertical space* and / or *Horizontal space*. #. Click the *Insert* button. .. figure:: /images/tinymce_insert_image.* :alt: Insert an image into a journal post Link an external image in a journal post .. 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:: pair: Journal; Add image from Mahara Add an image from Mahara ^^^^^^^^^^^^^^^^^^^^^^^^^^ #. Attach the image to your journal entry. #. Go to the visual editor and click on the *Image* button |tinymce_image|. #. Choose the image from the drop-down list *Attached image*. #. Provide a description for your image. #. Select the alignment to the text for your image. #. Change the dimensions of your image if they are too large. IF the image is recognised correctly, you have the image's dimensions displayed. #. Add a border to your image if you wish to do so. #. Add more space around the image by adding a number in *Vertical space* and / or *Horizontal space*. #. Click on the *Insert* button. 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. .. |edit| image:: /images/buttons/edit.* .. |delete| image:: /images/buttons/remove.* .. |unzip| image:: /images/buttons/unzip.* .. |tinymce_image| image:: /images/buttons/tinymce_image.*