plotly / orca

Command line application for generating static images of interactive plotly charts
MIT License
296 stars 39 forks source link

Standalone binaries Linux: Installation Problems #289

Open N0talent opened 4 years ago

N0talent commented 4 years ago

Hello!

Im not reporting a bug, but instead a suggestion for the installation guide.

I had Problems installing Orca using Ubuntu 18.04. I'm not a Pro Linux user, so maybe the Problem was trivial, but i still would like to share. ################## Problem

the normal installation Descriptions is as follow:

Linux
Make the orca AppImage executable.
$ chmod +x orca-X.Y.Z-x86_64.AppImage
Create a symbolic link named orca somewhere on your PATH that points to the AppImage.
$ ln -s /path/to/orca-X.Y.Z-x86_64.AppImage /somewhere/on/PATH/orca
Open a new terminal and verify that the orca executable is available on your PATH.
$ which orca
/somewhere/on/PATH/orca

$ orca --help
Plotly's image-exporting utilities

  Usage: orca [--version] [--help] <command> [<args>]

Following this installation did not work for me, because (i think) ubuntu has already had its own "orca" file, which it uses for Libra and other visual stuff. Once I followed the installation guide and checked if Installation was successful buy entering $ which orca into the console, the path displayed was the PATH of the "ubuntu orca". With this Setting Orca did not work with Plotly in R, as it did not find the "correct" orca file. I also set the environment in R using

 Sys.setenv(PATH =
 paste0("/somewhere/on/PATH/",.Platform$path.sep,Sys.getenv("PATH"))
 )

but that also did not find the newly installed Orca. ################## Solution instead of using linking the file to " /somewhere/on/PATH" with ln -s /path/to/orca-X.Y.Z-x86_64.AppImage /somewhere/on/PATH/orca I copied it to that path with sudo cp /path/to/orca-X.Y.Z-x86_64.AppImage /somewhere/on/PATH/orca

Basically making my installation Steps as follows:

Linux
Make the orca AppImage executable.
$ chmod +x orca-X.Y.Z-x86_64.AppImage
Create a symbolic link named orca somewhere on your PATH that points to the AppImage.
$ sudo cp /path/to/orca-X.Y.Z-x86_64.AppImage /somewhere/on/PATH/orca

Checking orca PATH will **not** verify if orca is Installed.
`$ which orca `
**instead** Open R/Rstudio and set enviorment:
 Sys.setenv(PATH =
 paste0("/somewhere/on/PATH/",.Platform$path.sep,Sys.getenv("PATH"))
or change Environment path in Linux

Maybe I did something working in my Installation, maybe not. If i did i would be happy to here what my error was, otherwise I hope this helps :) Maybe adding this solution to "trouble shooting: which orca shows wrong PATH" might be helpful for futer users that have my Problem.

Thanks for the Contribution of orca!!