Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
T
tails
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
952
Issues
952
List
Boards
Labels
Service Desk
Milestones
Merge Requests
10
Merge Requests
10
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Operations
Operations
Incidents
Environments
Analytics
Analytics
CI / CD
Repository
Value Stream
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
tails
tails
Commits
3b2ccab3
Commit
3b2ccab3
authored
Nov 17, 2018
by
sajolida
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update design documentation
parent
2d8fe724
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
21 additions
and
25 deletions
+21
-25
wiki/src/contribute/design/installation_assistant.mdwn
wiki/src/contribute/design/installation_assistant.mdwn
+21
-25
No files found.
wiki/src/contribute/design/installation_assistant.mdwn
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:
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment