Adding instructions for MacOS X users

This commit is contained in:
David Andrs 2021-08-13 12:07:46 -06:00 committed by Rebecca
parent 72f41093f0
commit a64bf79ca7
6 changed files with 66 additions and 1 deletions

28
_layouts/page.html Normal file
View file

@ -0,0 +1,28 @@
<!DOCTYPE html>
<html lang="{{ site.lang | default: "en-US" }}">
<head>
{% seo %}
<link rel="preconnect" href="https://fonts.gstatic.com">
<link rel="preload" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700&display=swap" as="style" type="text/css" crossorigin>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#157878">
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
<link rel="stylesheet" href="{{ '/assets/css/style.css?v=' | append: site.github.build_revision | relative_url }}">
</head>
<body>
<header class="page-header" role="banner">
<h1 class="project-name"><img class="logo" align="top" src="{{ site.baseurl}}/assets/images/logo.png"> {{ site.title | default: site.github.repository_name }}</h1>
<h2 class="project-tagline">{{ page.description | default: site.description | default: site.github.project_tagline }}</h2>
</header>
<main id="content" class="main-content" role="main">
{{ content }}
<footer class="site-footer">
<span class="site-footer-owner"><a href="{{ site.github.repository_url }}">{{ site.title }}</a> is published under {{ site.github.license.name }}.</span>
<span class="site-footer-credits">This page was generated by <a href="https://pages.github.com">GitHub Pages</a>.</span>
</footer>
</main>
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

View file

@ -16,6 +16,7 @@ Get the zip file for your operating system (Windows, Linux, macOS) from the [lat
**Linux users** who want to have BeeRef appear in the app menu, save the desktop file from the [release section]({{ site.github.latest_release.html_url }}) in `~/.local/share/applications` and adjust the path names in the file to match the location of your BeeRef installation.
**MacOS X users**, look at [detailed instructions]({% link macosx-run.md %}) if you have problems running BeeRef.
## Features
@ -37,4 +38,4 @@ The bee file format is a sqlite database inside which the images are stored in a
sqlite3 myfile.bee -Axv
```
Options for exporting from inside BeeRef are planned, but the above always works independently of BeeRef.
Options for exporting from inside BeeRef are planned, but the above always works independently of BeeRef.

36
macosx-run.md Normal file
View file

@ -0,0 +1,36 @@
---
layout: page
---
## How to run on Mac OS X
When you open the `BeeRef.app` bundle, and you see the following error, keep reading.
<center>
<img src="{{ site.baseurl}}/assets/images/macosx-unidentified-dev.png" alt="Unidentified developer" width="248"/>
</center>
The following steps will walk you though the process that will allow you to run BeeRef:
* Click **OK** to close the above error
* Click on the Apple logo in the menu bar and select **System preferences...**
* Go to **Security & Privacy** tab and select the **General** tab
* Now you should see the text as shown on the image below:
<center>
<img src="{{ site.baseurl}}/assets/images/macosx-open-from-sys-prefs.png" alt="Allow from system preferences" width="570"/>
</center>
* Click **Open Anyway**
* Go back to the location where you have `BeeRef.app` and double click it to run it again.
* You will be greeted by the warning shown below:
<center>
<img src="{{ site.baseurl}}/assets/images/macosx-open-anyway.png" alt="Open anyway" width="251"/>
</center>
* Click **Open** and `BeeRef` should run
Luckily, you have to do this only once.
[Back](/)