# SOME DESCRIPTIVE TITLE. # Copyright (C) 2022, The Funkwhale Collective # This file is distributed under the same license as the funkwhale package. # FIRST AUTHOR , 2022. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: funkwhale 1.2.5\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2022-07-01 10:35+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.10.1\n" #: ../../documentation/rearrange.rst:2 msgid "Rearranging Files" msgstr "" #: ../../documentation/rearrange.rst:4 msgid "" "Sometimes, rearranging the layout of documents in the docs folder can " "help to make things a bit clearer for users. However, this can present " "the following issues:" msgstr "" #: ../../documentation/rearrange.rst:7 msgid ":ref:`Orphaned document links `" msgstr "" #: ../../documentation/rearrange.rst:8 msgid ":ref:`Orphaned URLs `" msgstr "" #: ../../documentation/rearrange.rst:13 msgid "Orphaned Document Links" msgstr "" #: ../../documentation/rearrange.rst:15 msgid "" "Documents frequently reference other documents to avoid repeating " "information. If you move a document, you need to be sure to update any " "orphaned references." msgstr "" #: ../../documentation/rearrange.rst:18 msgid "" "Running ``make html`` in the ``docs`` directory (assuming you have " ":doc:`Sphinx installed `) will generate a series of warnings " "letting you know if any links are orphaned." msgstr "" #: ../../documentation/rearrange.rst:25 msgid "" "You can then go to the file/line in question and update the link to its " "new location." msgstr "" #: ../../documentation/rearrange.rst:30 msgid "Orphaned URLs" msgstr "" #: ../../documentation/rearrange.rst:32 msgid "" "Once internal document links have been resolved, it is important to " "consider that the moved file may have also been linked externally " "elsewhere before. In order to ensure that anybody trying to access the " "file is properly redirected to its new location, we need to make use of " "the link redirector in the ``conf.py`` file." msgstr "" #: ../../documentation/rearrange.rst:37 msgid "" "The link redirector takes two arguments: the old location of the file " "(passed as a .html file at the relative path ``docs``), and the new " "location it should redirect to. For example, if a document was moved from" " ``docs/index.html`` to ``docs/admin/index.html``, we would add the " "following to the ``redirect_files`` section of ``conf.py``:" msgstr "" #: ../../documentation/rearrange.rst:53 msgid "" "If you are moving something from one folder to another, you would need to" " tell the redirect to move to the correct level. For example, if a file " "is moving from ``docs/admin/index.html`` to ``docs/users/index.html``, " "you will need to add the following to the ``redirect_files`` section of " "``conf.py``:" msgstr "" #: ../../documentation/rearrange.rst:69 msgid "" "The script will then take these two arguments and create a redirect file " "in the original location so that anybody accessing the existing URL will " "be redirected." msgstr ""