/
Flowpaper

Flowpaper

Owned by Erik Meade (Unlicensed)
Last updated: Aug 23, 2017Version comment

Github:

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

Gitlab:

https://gitlab.com/uhawaii-system-its-mis/docker-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:
    • 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

Flowpaper displays PDFs that have been converted to Flash (SWF) or html/html5.

  • 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.
  • 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.
  • 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

Default look and feel of Annotation screen:

Desktop:

Tablet

Mobile