This article outlines how to set up a MindTouch media repository for file management.
Why should I set up a media repository?
Set up a media repository to allow for ease of file management and avoid broken images if pages are deleted:
- Reuse files throughout your site.
- Update reused files in one central location.
- Access files even after a page containing the files has been deleted.
Set up your media repository
Perform the following steps to set you your media repository:
Step 1: Install the media repository
- Download the media repository MTARC file.
- Install the media repository MTARC file in each of your categories:
- Click Options > Import here.
- Find your media repository MTARC and select to import.
- MindTouch pages, including media repositories, can only display up to 100 file attachments. If you think you will put more than 100 files into your media repository, we recommend creating sub-repositories within the main repository as needed. To make organization and reuse easier, mimic the top-level structure of your MindTouch site.
Step 2: Set permissions
In order to make the media repository accessible to your pro members but hidden to your end users, follow these steps:
- Click on the recently installed Media Repo.
- Click Options > Restrict access and select Semi-Private.
- Add any users or groups that will need access to the media repository to manage files.
- If you are creating subpages in your media repository categories, make sure to select Apply restrictions settings to all to subpages.
With your media repository set to semi-private, end users will be able to view images that are attached to that page, but the media repository pages won't show up in navigation or in search unless users are explicitly added to the permissions list. Review how to restrict access.
Step 3: Identify a structure for ease of management
First, identify the structure of the documentation you are going to create. Mirror the organization within your categories to ease file management.
If you are creating subpages, verify the appropriate access permissions are granted. To change permissions, see step 2.
Step 4: Add files
- Navigate to the bottom of the media repository page.
- Click Attach a file or drag and drop the files directly into the File table.
Step 5: Add files from the media repo to your pages
- Open the page into which you want to insert a file or image in Edit mode.
- In the editor toolbar, click the Image icon .
- Browse to your media repository or search by the file's name.
- Click Save image.
Learn how to move images on your pages into your media repository. If you have any questions about the best way to structure the media repository, please feel free to reach out to our support team.