Skip to content

Commit

Permalink
update window installation instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
marcolarosa committed May 28, 2024
1 parent fcb24d5 commit 3238a28
Show file tree
Hide file tree
Showing 42 changed files with 38 additions and 54 deletions.
75 changes: 23 additions & 52 deletions src/docs/guide/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,63 +28,34 @@ Apple MacOS will let you install these applications as they are signed and check

## Windows

Two installers are available for Windows: `Describo-${version}-Setup.exe` and
` Describo-win32-x64-${vesion}.zip`.
Two installers are available for Windows:

::: warning NOTE!
- `Describo-x64-${version}.Setup.exe` - most people will probably want this version
- `Describo-arm64-${version}.Setup.exe` - choose this if you have an ARM processor. If you don't
know what that is, get the version above.

As these builds are not signed, Windows will not automatically run them. However, with a few clicks,
you can get Describo going.

:::

### Install from the setup file

Using the setup file will install Describo in the normal windows locations as well as create a link
on the Desktop. But it takes a few steps to get this to happen.

1. In the downloads section of the browser (shown is Microsoft Edge), you will see a message about
trusting this download. If you hover over it, a button with an ellipsis (...) will show. Hover
over that and you will get the following dropdown. Select `Keep`.

<img src="/images/windows/windows-setup1.webp" data-zoomable />

2. When the following dialog shows, select `Show more`.

<img src="/images/windows/windows-setup2.webp" data-zoomable />

3. The select `Keep anyway`.

<img src="/images/windows/windows-setup3.webp" data-zoomable />

4. Then in your downloads folder (or wherever the file saved to) you will see the Describo Setup
file. Double click it to install the application.

<img src="/images/windows/windows-setup4.webp" data-zoomable />

### Install from the ZIP file

1. After you've downloaded the file to your computer, go to your `Downloads` folder and unzip the
file. Do this by selecting it and then clicking the `Extract all` button.

<img src="/images/windows/windows-extract1.webp" data-zoomable />

2. You will then be prompted to extract it somewhere. Choose a folder and select `Extract`

<img src="/images/windows/windows-extract2.webp" data-zoomable />

3. When that's done, if "Show extracted files when complete" was selected, an explorer window will
open and you can start the `Describo` application. (If not, find the folder you extracted the
application to and then start it).
::: tip INFO

<img src="/images/windows/windows-extract3.webp" data-zoomable />
Although the executables are signed, Windows Defender may still pop up a warning. This is because
Describo is not yet known to it. Over time, this should go away.

4. You may be confronted with a message saying "Windows protected your PC". If you are, select
`More info` and then `Run anyway`. See images following.
:::

<div class="flex flex-row justify-around">
<div><img src="/images/windows/windows-sig1.webp" class="h-96" data-zoomable /></div>
<div><img src="/images/windows/windows-sig2.webp" class="h-96" data-zoomable /></div>
The setup file will install Describo in the normal windows locations as well as create a link on the
Desktop.

If you are confronted with a message saying "Windows protected your PC" like in the following
images, select `More info` and confirm that the Publisher field is set to
`AU, Victoria, Melbourne, Marco La Rosa, Marco La Rosa`. If it is (and it should be), select
`Run anyway`.

<div class="flex flex-col md:flex-row space-x-1">
<div>
<img src="/images/windows/windows-install1.webp" data-zoomable />
</div>
<div>
<img src="/images/windows/windows-install2.webp" data-zoomable />
</div>
</div>

## Linux
Expand Down
Binary file modified src/public/images/logos/describo-logo-name.webp
Binary file not shown.
Binary file modified src/public/images/logos/describo-logo.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop1.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop10.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop11.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop12.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop13.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop3.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop4.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop6.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop7.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop8.webp
Binary file not shown.
Binary file modified src/public/images/tour/desktop9.webp
Binary file not shown.
Binary file modified src/public/images/tutorial-discover/discover1.webp
Binary file not shown.
Binary file modified src/public/images/tutorial-working-with-a-crate/template1.webp
Binary file not shown.
Binary file modified src/public/images/tutorial-working-with-a-crate/template2.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-extract1.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-extract1.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-extract2.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-extract2.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-extract3.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-extract3.webp
Binary file not shown.
Binary file added src/public/images/windows/windows-install1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/public/images/windows/windows-install1.webp
Binary file not shown.
Binary file added src/public/images/windows/windows-install2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/public/images/windows/windows-install2.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup1.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup1.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup2.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup2.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup3.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup3.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup4.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup4.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup5.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-setup5.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-sig1.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-sig1.webp
Binary file not shown.
Binary file removed src/public/images/windows/windows-sig2.png
Binary file not shown.
Binary file removed src/public/images/windows/windows-sig2.webp
Binary file not shown.
17 changes: 15 additions & 2 deletions src/vue-components/Releases.vue
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,15 @@
</div>
<div class="flex flex-col">
<LinkComponent :link="data.download.wintel" target="">
<div>Download for Intel processors</div>
<div class="flex flex-row space-x-2 items-center">
<div>
<img src="/images/logos/intel.png" class="h-10" />
</div>
<div>Download for Intel processors</div>
</div>
</LinkComponent>
<LinkComponent :link="data.download.winarm" target="">
<div>Download for ARM processors</div>
</LinkComponent>
<TipComponent class="text-center">
Be sure to read the
Expand All @@ -62,7 +70,12 @@
</div>
<div class="flex flex-col">
<LinkComponent :link="data.download.linux" target="">
<div>Download for Intel processors</div>
<div class="flex flex-row space-x-2 items-center">
<div>
<img src="/images/logos/intel.png" class="h-10" />
</div>
<div>Download for Intel processors</div>
</div>
</LinkComponent>
<TipComponent class="text-center">
Be sure to read the
Expand Down

0 comments on commit 3238a28

Please sign in to comment.