Skip to content
GitLab
Explore
Sign in
Register
Primary navigation
Search or go to…
Project
tails
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Deploy
Releases
Model registry
Monitor
Incidents
Service Desk
Analyze
Value stream analytics
Contributor analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Cody Brownstein
tails
Commits
3b2ccab3
Commit
3b2ccab3
authored
6 years ago
by
sajolida
Browse files
Options
Downloads
Patches
Plain Diff
Update design documentation
parent
2d8fe724
No related branches found
No related tags found
No related merge requests found
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
wiki/src/contribute/design/installation_assistant.mdwn
+21
-25
21 additions, 25 deletions
wiki/src/contribute/design/installation_assistant.mdwn
with
21 additions
and
25 deletions
wiki/src/contribute/design/installation_assistant.mdwn
+
21
−
25
View file @
3b2ccab3
...
...
@@ -21,13 +21,12 @@ being usable by expert users.
The following scenarios are proposed:
- [[
Install
from another Tails (for PC)|install/win/clone-overview]]
- [[
Install
from another Tails (for Mac)|install/mac/clone-overview]]
- [[
Clone
from another Tails (for PC)|install/win/clone-overview]]
- [[
Clone
from another Tails (for Mac)|install/mac/clone-overview]]
- [[Install from Windows|install/win/usb-overview]]
- [[Install from Debian, Ubuntu, or Mint|install/debian/usb-overview]]
- [[Install from macOS|install/mac/usb-overview]]
- [[Install from Linux (all distributions)|install/linux/usb-overview]]
- [[Install from Debian, Ubuntu, or Mint using the command line and GnuPG|install/expert/usb-overview]]
- [[Install from other Linux distributions|install/linux/usb-overview]]
- [[Install from macOS and the command line|install/mac/usb-overview]]
- [[Burn a DVD|install/dvd]]
- [[Download only for USB sticks|install/download]]
- [[Download only for DVDs and virtual machines|install/download-iso]]
...
...
@@ -71,8 +70,7 @@ massive amount of content in ikiwiki.
The [inline directive](https://ikiwiki.info/ikiwiki/directive/inline/) of
ikiwiki allows embedding a file into another file to avoid duplicating content.
It is quite limited and brittle, especially when used together with the PO
plugin. See [[!tails_ticket 6907]]. Many inlines also slow down the build
process quite a lot.
plugin. See [[!tails_ticket 6907]].
### Conditional CSS content
...
...
@@ -82,7 +80,7 @@ program used to install an intermediary Tails on Windows and Linux we
wrote:
<pre>
<span class="windows">a program called
Universal USB Install
er.</span>
<span class="windows">a program called
Etch
er.</span>
<span class="linux">a program called GNOME Disks.</span>
</pre>
...
...
@@ -92,25 +90,20 @@ scenario and elements with the
- Classes for elements potentially displayed on different pages:
- `clone` for content involving cloning
- `download` for all download pages
- `usb` for content with a USB stick as destination device
- `windows` for content for Windows
- `mac` for content for macOS
- `debian` for content for Debian, Ubuntu, or Mint
- `expert` for content for Debian, Ubuntu, or Mint on the command line
- `linux` for content for other Linux
- `upgrade` for content for manual upgrade
- Classes for elements displayed only on one scenario:
- `windows` for [[/install/win/usb|/install/win/usb]]
- `mac` for [[/install/mac/usb|/install/mac/usb]]
- `linux` for [[/install/linux/usb|/install/linux/usb]]
- `expert` for [[/install/expert/usb|/install/expert/usb]]
- `dvd` for [[/install/dvd-download|/install/dvd-download]]
- `vm` for [[/
doc/advanced_topics/virtualization|/doc/advanced_topics/virtualization
]]
- `vm` for [[/
install/vm-download|/install/vm-download
]]
- `download-only-img` for [[/install/download|/install/download]]
- `download-only-iso` for [[/install/download|/install/download-iso]]
- `install-clone` for [[/install/clone|/install/clone]]
- `windows-usb` for [[/install/win/usb|/install/win/usb]]
- `mac-usb` for [[/install/mac/usb|/install/mac/usb]]
- `mac-clone` for [[/install/mac/clone|/install/mac/clone]]
- `debian-usb` for [[/install/debian/usb|/install/debian/usb]]
- `expert-usb` for [[/install/expert/usb|/install/expert/usb]]
- `linux-usb` for [[/install/linux/usb|/install/linux/usb]]
- `upgrade-clone` for [[/upgrade/clone|/upgrade/clone]]
- `upgrade-tails` for [[/upgrade/tails|/upgrade/tails]]
...
...
@@ -124,8 +117,7 @@ installation scenario to follow. It is divided by operating systems:
- Windows
- macOS
- Linux with `APT` and `tails-installer`: Debian, Ubuntu, or Mint
- Other Linux distributions
- Linux
Notes:
...
...
@@ -180,9 +172,9 @@ The *overview* is a single page summarizing graphically:
next and how complex it is. This is particularly important as the
*steps* are a single and very long page.
For example, the content of the overview for installing from
Debian
is
stored in [[!tails_gitweb wiki/src/install/
debia
n/usb-overview.html]] which includes a common block of
HTML stored in [[!tails_gitweb wiki/src/install/inc/overview.html]] and uses the `
debian
` CSS
For example, the content of the overview for installing from
Windows
is
stored in [[!tails_gitweb wiki/src/install/
wi
n/usb-overview.html]] which includes a common block of
HTML stored in [[!tails_gitweb wiki/src/install/inc/overview.html]] and uses the `
windows
` CSS
class to adapt to the scenario.
<a id="download"></a>
...
...
@@ -191,7 +183,7 @@ Download
========
The download of the ISO image comes as a dedicated page between the
overview and steps (except for `clone`, `upgrade-clone`, and `expert`). It
overview and steps (except for `
install-clone`, `mac-
clone`, `upgrade-clone`, and `expert`). It
is also available as a [[standalone page|install/download]].
The download is split as a dedicated page (while still labeled as "Step
...
...
@@ -199,6 +191,10 @@ The download is split as a dedicated page (while still labeled as "Step
possible to skip the download or even the verification but the link to
do so is labeled as a warning.
Depending on the installation scenario, the download page points to the
download of the ISO image (on `dvd` and `vm`) or the USB image (on all
other scenarios).
We propose two download techniques displayed in equal weight and combined
with two verification techniques that have a level of verification at least as
good as HTTPS:
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment