.. include:: /shortcuts.rstext .. index:: single: Content; Journal single: Enable multiple journals single: Unpublish a journal entry per the "Unpublish" button .. _journal: Journals ---------- *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 #. Creation date of the journal entry #. Tags associated with the journal entry #. Beginning of the journal entry #. If a journal entry is labeled *Published*, you can click the *Unpublish* button to revert it back to draft status. #. 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. .. note:: When you publish a journal, you do not automatically make it available to others or make it public on the internet. The journal or journal entry still needs to be put into a page that is then shared with others in order for them to see it. #. Click the *Edit* button |edit| to make changes to your journal entry. #. Click the *Delete* button |delete| to delete your journal entry. #. Number of entries in your journal .. index:: single: Journal; Settings single: 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. #. **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 `. #. **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: 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. #. **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 `. #. **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**: Change the status of the switch box to "Yes" 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 image Add an image into a journal entry ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. note:: Please refer to the section ":ref:`Insert an image into text `" for more information. .. 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 in the pop-up click on the file name to select the file(s) from your *Files* area that you wish to attach. .. note:: You can click anywhere in the space around the file that you want to add as an attachment to select it for your journal entry. Alternatively, you can upload additional files directly. #. **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 `. #. **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. #. **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. #. 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 `. #. Click the *Browse* button to select a file from your computer to upload. #. :index:`Instead of clicking ` the *Browse* button to upload files, you can drag and drop files from your computer directly onto the "drop zone". You must still observe the maximum file size upload for each file and the maximum total file size cannot be exceeded either. .. note:: This functionality is not available in all browsers. Generally, users of Chrome 7+, Firefox 4+, Internet Explorer 10+, Opera 12+ (Windows only) and Safari 6+ can use drag and drop. #. Click the *Close* icon |close| to return to your journal entry. #. If you attached a file that you do not wish to attach anymore, you can click the *Remove* button to take it off your list of attachments. #. Once you are done, you can click the *Save* button to save the changes to your journal entry. .. note:: You do not need to attach an image in order to display it in your journal entry. You can :ref:`insert it easily `. .. index:: single: Journal; Multiple journals .. _multiple_journals: Work with multiple journals ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you wish to use more than one journal, 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 set the switch box for *Multiple journals* to "Yes". .. 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. The titles link through to the individual journals. #. You can see the description of the journal. #. You see how many entries you have in each journal. #. Click the *Arrow* icon |arrow-to-right| to be taken to the journal and see all journal entries. #. Click the *New entry* button to create a new journal entry directly from this screen. #. Click the *Edit* button |edit| to make changes to your journal title, description or tags. #. Click the *Delete* button |delete| to delete the journal and all its entries. .. warning:: When you click the *Delete* button, you receive a confirmation message whether you really want to delete the journal or not. :index:`If you used the journal or an entry of it in a page `, Mahara lets you know so you can decide whether to delete the journal or not. Once you agree to delete the journal, your journal and all its content are removed permanently.