https://github.com/dirtyhawk/stata-integration
A bundled Linux binary script integrating an already installed Stata instance into the desktop environment
https://github.com/dirtyhawk/stata-integration
stata
Last synced: about 2 months ago
JSON representation
A bundled Linux binary script integrating an already installed Stata instance into the desktop environment
- Host: GitHub
- URL: https://github.com/dirtyhawk/stata-integration
- Owner: dirtyhawk
- License: gpl-3.0
- Created: 2017-10-05T09:39:42.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-03-28T23:26:45.000Z (almost 2 years ago)
- Last Synced: 2024-03-29T00:22:25.660Z (almost 2 years ago)
- Topics: stata
- Language: Shell
- Size: 171 MB
- Stars: 28
- Watchers: 5
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# stata-integration
A bundled Linux binary script integrating an already installed Stata instance into the desktop environment
## About
The script will do the following:
1. ask for some information regarding the Stata environment it is faced with (installation path, Stata version, etc);
2. apply a workaround which fixes an issue where all menu icons in Stata's GUI are missing in modern Linux distributions; this is done by manually downloading and building older variants of `zlib` (1.2.3) and `libpng` (1.6.2) as well as a prior version of `libpng` (1.2.59); details on why this might be necessary can be found [here on Statalist](http://www.statalist.org/forums/forum/general-stata-discussion/general/2199-linux-stata-bug-libpng-on-newer-opensuse-possibly-other-distributions); the blueprint for the installation procedure has been sketched from [this script on BitBucket](https://bitbucket.org/vilhuberl/stata-png-fix) by [Lars Vilhuber](https://www.vilhuber.com/lars/); this workaround is no longer required with modern Stata versions, as version 16 or younger bundles all necessary libraries within its installation;
3. install an application menu entry for Stata's windowed and console variant;
4. install all mimetypes relevant to Stata (.do, .dta, .dtas, .smcl, .gph, .stpr, .stsem);
5. install file-type associations for each newly installed mimetype to Stata;
6. install Stata icons for the application menu entry as well as each mimetype in several sizes;
7. make Stata the default application for opening the newly installed mimetypes for each user requested
Use at your own risk. The script has been tested on Ubuntu (16.04 through 25.10), on Fedora Workstation 39, and on Manjaro 25. It should work in all modern Linux desktop environments that support the [freedesktop.org](https://www.freedesktop.org) specifications on [icons](https://specifications.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html), [application shortcuts](https://specifications.freedesktop.org/desktop-entry-spec/latest/) and [mimetypes](https://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec/). I, however, do no not warrant this. Actually, I do not even warrant that the script works at all. That's *your own risk*.
## Usage
Simply run `stata-integration.bin` in a terminal window and **read** and follow the on-screen instructions.
## Contributions
Many thanks to the contribution by [@pedromezaq](https://www.github.com/pedromezaq), who added the necessary resources for Stata 18. [@marco-cordori](https://www.github.com/marco-cordori) followed his example and added the resources for Stata 19. If anyone else is willing to contribute, reach out by starting an issue and / or pull request like he did!
## Copyright notice
All icons have been extracted from the official Stata for Windows binaries and are, as well as the term 'Stata', of course copyrighted property of StataCorp LLC.