Skip to content

Basic Operations for File Box

suewonjp edited this page Mar 19, 2017 · 10 revisions

βœ”οΈ Uploading a File

  1. Right-click anywhere on the empty space in File Box to invoke the context menu.
  2. Click Upload File from the context menu.
  3. The Upload Dialog will appear.
  4. Select the destination folder where your file will be placed in File Box.
    • When the destination folder is selected, its font color will become cyan like the figure below
  5. Click Choose button.
    • This will bring up the file upload dialog of your browser.
    • Choose the file you'd like to upload and confirm it.
    • Then OK button will appear at the bottom with some shake animation.
  6. Click the OK button.

NOTE
When you upload a file to the location where there already exists a file with the same name, the uploaded file will overwrite the existing one (Since version 0.9.0.RC6)

file upload dialog
Figure 1. File Upload Dialog

βœ”οΈ Inserting a link to a File into a Fragment

This operation can be performed with a simple Drag & Drop.

  1. Open Fragment Editor to edit the Fragment that you want to hold a link to the target file.
  2. Grab the target file in File Box with your mouse.
  3. Drag and drop it to the content area (textarea elemnt) in Fragment Editor.
  4. A Civilizer Custom Markup Command will be generated at the place where the caret was located.
  5. After saving the Fragment, you can see a link to the file generated. (If the file is an image, the image will be shown instead of link)
  6. What will happen by clicking the link depends on:
    • The type of file.
    • Behavior of your browser specified for that type of file. (mostly downloading)

βœ”οΈ Renaming a File/Folder

  1. Right-click on the file/folder you'd like to rename.
  2. A dialog appears.
  3. Rename it.
  4. Click OK.

βœ”οΈ Moving a File/Folder

  1. Right-click on the file/folder you'd like to move.
  2. A Move Dialog will appear. (Its appearance is similar to the File Upload Dialog)
  3. Select the destination folder.
    • When moving a folder, You can't move it to certain destinations:
      • Such as to a folder which is the moving folder's sub folder.
      • In such cases, a warning message will appear and you won't be able to proceed.
    • When moving a folder, all of its sub folders and files will be moved.
  4. Click OK.

βœ”οΈ Deleting a File/Folder

  1. Right-click on the file/folder you'd like to delete.
  2. Click OK on the confirm dialog.

βœ”οΈ File Info (Since 0.9.0.RC4)

  1. Right-click on the file/folder you'd like to check out.
  2. This will bring up the information window for the file/folder.
    • You have a path to the file/folder at the top.
      • If the target is a file, the path is clickable.
      • So you can download or view the file based on your browser's setting on the file type.
    • You'll see Get Fragments Containing This File link in the middle.
      • By clicking the link, all Fragments linked with that file will be fetched.
    • If the file is a image format that Civilizer recognizes, then the window will display the image.

βœ”οΈ Limitations of File Box

NOTE
The following limitation used to exist in older versions, But is irrelevant for newer versions (Since 0.9.0.RC6)

  • You can't update any of existing files in File Box through Civilizer UI interface.
    • When you try to upload a file to the location where a file with the same name already has been placed, an error will occur.
    • You can do either of the following workarounds:
      • Delete or move the existing file first, then upload the new file.
      • Highly likely, you may have access to the underling file system if you run Civilizer on your desktop. So you can replace the target file via the native file system.
        • To figure out the File Box location on your file system, refer to civilizer.file_box_home option in your app-options.properties file
Clone this wiki locally