Versions Compared

Version Old Version 16 New Version Current
Changes made by

Erik Meade

Erik Meade

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Annotation notes

Github:

https://github.com/UniversityOfHawaii/uh-its-flexpaper

...

  • Running uh-its-flexpaper with uh-its-tenure see github uh-its-flexpaper/aws  and was-02c-annotations.sh
  • Running uh-its-flexpaper standalone:
    • Code Block
      git clone https://github.com/UniversityOfHawaii/uh-its-flexpaper.git
cd uh-its-flexpaper
mv code ../vol-code
cd 
rm -rf uh-its-flexpaper
 
mkdir vol-tomcat-logs
mkdir vol-tomcat-work
mkdir vol-flexpaper-work
mkdir vol-flexpaper-pdf
mkdir vol-pdftk-work
 
docker login registry.gitlab.com
 
docker run -v /etc/localtime:/etc/localtime:ro -v $HOME/vol-tomcat-logs:/apache-tomcat-8.5.11/logs -v $HOME/vol-tomcat-work:/apache-tomcat-8.5.11/work -v $HOME/vol-code:/apache-tomcat-8.5.11/webapps/ROOT -v $HOME/vol-flexpaper-work:/flexpaper-work -v $HOME/vol-flexpaper-pdf:/flexpaper-pdf -v $HOME/vol-pdftk-work:/pdftk-work -e CATALINA_HOME=/apache-tomcat-8.5.11 -p 80:8080 -p 443:8443 registry.gitlab.com/uhawaii-system-its-mis/docker-flexpaper /apache-tomcat-8.5.11/bin/catalina.sh run

      Here vol-flexpaper-pdf, which is mapped to /flexpaper-pdf has the role of the storage directory in tenure.

    • Converted files are stored in vol-flexpaper-work which is mapped to /flexpaper-work in directories named after the tenure application id.

License:

    • Log into https://flowpaper.com/account/ with the invoice email address and access code
    • Download and install a Desktop version of FlowPaper
    • Start and log into Desktop with invoice email and access code.
    • Import and publish a PDF via "Manually copy to a server" with IP address or domain that app will be running from
    • Show Folder.
    • License will be the key value in the index.html of the shown folder.

File Formats:

  • PDF is the main file format supported.  Faculty will have the most control if they convert their files to PDFs before uploading.
  • Microsoft file formats can be difficult to convert to PDF correctly when Microsoft tools are not used.  https://askubuntu.com/questions/396825/convert-docx-to-pdf
  • Images can be converted reliably with imagemagick, though FlowPaper files need to have this capability added to them.

Annotations:

  • Flexpaper classic is the tool that allows annotations.
    • Annotations are separate from document and APIs need to be called to save and restore annotations.
      • uh-its-tenure annotation branch
        • AnnotationRestController.java
        • AnnotationService.java
        • Annotation.java

DRAFT NOTES: still figuring things out

...

  • Windows and OS X desktop app creates various websites from a PDF, including a Java war file.
    • The Java version war, does appear to convert uploaded PDFs to SWF.
      • Spaces in file names need to be converted/removed before pdf2swf or java modified to quote output to command line calls
      • Upload page does not refresh automatically (click Configuration and cancel)
        • clicking on file in Available Documents starts conversion process.
  • Unix - Flowpaper recommends conversion of PDFs to Flash using SWFTools there are many others free and commercial.
  • Flexpaper classic is the tool that allows annotations.
    • Annotations are separate from document and APIs need to be called to save and restore annotations.
  • FlowPaper_Annotations_Trial has Annotation code and is very similar to FlexPaper in the Java war (mentioned above)
  • Flexpaper github (now Flowpaper) has several repositories and forks.
    • Flexpaper on github displays SWFs, the repository description says it displays PDFs I haven't seen this and there are no PDF files in the examples or demos, just SWFs
  • Flexpaper-desktop-publisher is a Google code Archive of Downloads of tools in Flexpaper github above.Other formats we wish to support it appears we will have to convert to PDF (using the myriad of tools available) and then to SWF.
  • Remove password logic from admin/index.jsp (leave session.setAttribute("FLOWPAPER_AUTH", "1"); )
  • Annotations (Marks) need to be saved and retrieved.  https://flowpaper.com/online-annotations-pdf-viewer-api/ 
  • MuPDF
  • License:
    • Log into https://flowpaper.com/account/ with the invoice email address and access code
    • Download and install a Desktop version of FlowPaper
    • Start and log into Desktop with invoice email and access code.
    • Import, and publish a PDF via "Manually copy to a server"
    • Show Folder.
    • License will be the key value in the index.html of the shown folder.

...

Default look and feel of Annotation screen:

...