Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 67d8d35f82 | |||
| 2c24dd4d4a |
@@ -1,23 +0,0 @@
|
|||||||
name: Check
|
|
||||||
|
|
||||||
on: [pull_request]
|
|
||||||
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
build:
|
|
||||||
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v1
|
|
||||||
- name: Install dependencies
|
|
||||||
run: |
|
|
||||||
export PATH="$HOME/.local/bin:$PATH"
|
|
||||||
sudo apt-get install -y python3-setuptools
|
|
||||||
pip3 install --user -r requirements.txt
|
|
||||||
- name: Build the docs
|
|
||||||
run: |
|
|
||||||
export PATH="$HOME/.local/bin:$PATH"
|
|
||||||
make py
|
|
||||||
make htmlall
|
|
||||||
|
|
||||||
@@ -1,39 +0,0 @@
|
|||||||
name: CI
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches:
|
|
||||||
- master
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
build:
|
|
||||||
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v1
|
|
||||||
- name: Install dependencies
|
|
||||||
run: |
|
|
||||||
export PATH="$HOME/.local/bin:$PATH"
|
|
||||||
sudo apt-get install -y python3-setuptools
|
|
||||||
pip3 install --user -r requirements.txt
|
|
||||||
- name: Build the docs
|
|
||||||
run: |
|
|
||||||
export PATH="$HOME/.local/bin:$PATH"
|
|
||||||
make py
|
|
||||||
make htmlall
|
|
||||||
- name: Pre-deploy
|
|
||||||
run: |
|
|
||||||
wget https://github.com/clearlinux/clear-linux-documentation-zh-CN/releases/latest/download/clearlinux-docs-zh-CN.tar.gz
|
|
||||||
mkdir source/_build/html/zh_CN
|
|
||||||
tar xvzf clearlinux-docs-zh-CN.tar.gz -C source/_build/html/zh_CN
|
|
||||||
mv source/_build/html $HOME/output
|
|
||||||
- name: Deploy the docs
|
|
||||||
run: |
|
|
||||||
cd $HOME/output
|
|
||||||
git init
|
|
||||||
git config --global user.name "${GITHUB_ACTOR}"
|
|
||||||
git config --global user.email "${GITHUB_ACTOR}@github.com"
|
|
||||||
git add .
|
|
||||||
git commit -m "latest html output"
|
|
||||||
git push -f https://${GITHUB_ACTOR}:${{secrets.ACCESS_TOKEN}}@github.com/clearlinux/clear-linux-documentation.git HEAD:developmentHTML
|
|
||||||
@@ -1,43 +0,0 @@
|
|||||||
name: Publish
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches:
|
|
||||||
- publish
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
build:
|
|
||||||
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v1
|
|
||||||
- name: Install dependencies
|
|
||||||
run: |
|
|
||||||
export PATH="$HOME/.local/bin:$PATH"
|
|
||||||
sudo apt-get install -y python3-setuptools
|
|
||||||
pip3 install --user -r requirements.txt
|
|
||||||
- name: Build the docs
|
|
||||||
run: |
|
|
||||||
export PATH="$HOME/.local/bin:$PATH"
|
|
||||||
make py
|
|
||||||
make htmlall
|
|
||||||
- name: Pre-deploy
|
|
||||||
run: |
|
|
||||||
wget https://github.com/clearlinux/clear-linux-documentation-zh-CN/releases/latest/download/clearlinux-docs-zh-CN.tar.gz
|
|
||||||
mkdir source/_build/html/zh_CN
|
|
||||||
tar xvzf clearlinux-docs-zh-CN.tar.gz -C source/_build/html/zh_CN
|
|
||||||
mv source/_build/html $HOME/output
|
|
||||||
- name: Deploy the docs
|
|
||||||
run: |
|
|
||||||
cd $HOME/output
|
|
||||||
git init
|
|
||||||
git config --global user.name "${GITHUB_ACTOR}"
|
|
||||||
git config --global user.email "${GITHUB_ACTOR}@github.com"
|
|
||||||
git add .
|
|
||||||
git commit -m "latest html output"
|
|
||||||
git push -f https://${GITHUB_ACTOR}:${{secrets.ACCESS_TOKEN}}@github.com/clearlinux/clear-linux-documentation.git HEAD:latestHTML
|
|
||||||
- name: Publish the docs
|
|
||||||
run: |
|
|
||||||
wget ${{secrets.PUBLISH_URL}}
|
|
||||||
cat clearlinux-latest
|
|
||||||
@@ -176,16 +176,7 @@ displays a preview of the site at http://localhost:8000 on your local machine.
|
|||||||
|
|
||||||
To stop the web server simply use ``ctrl-c``.
|
To stop the web server simply use ``ctrl-c``.
|
||||||
|
|
||||||
<<<<<<< HEAD
|
|
||||||
|
|
||||||
### Silly header to test dev branch
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
.. _Clear Linux\* OS documentation: https://clearlinux.org/documentation
|
|
||||||
=======
|
|
||||||
.. _Clear Linux\* OS documentation: https://docs.01.org/clearlinux/
|
.. _Clear Linux\* OS documentation: https://docs.01.org/clearlinux/
|
||||||
>>>>>>> 550b919bc013159156f80110867aa1ab7c858d29
|
|
||||||
.. _Sphinx: http://sphinx-doc.org/
|
.. _Sphinx: http://sphinx-doc.org/
|
||||||
.. _reStructuredText: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
|
.. _reStructuredText: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
|
||||||
.. _contribution guidelines: https://docs.01.org/clearlinux/latest/collaboration/collaboration.html
|
.. _contribution guidelines: https://docs.01.org/clearlinux/latest/collaboration/collaboration.html
|
||||||
|
|||||||
@@ -5,5 +5,5 @@ sphinx_rtd_theme
|
|||||||
sphinx-intl==2.0.0
|
sphinx-intl==2.0.0
|
||||||
sphinx-sitemap==1.0.2
|
sphinx-sitemap==1.0.2
|
||||||
Jinja2==2.10.1
|
Jinja2==2.10.1
|
||||||
GitPython==3.0.8
|
GitPython==2.1.11
|
||||||
sphinx-tabs
|
sphinx-tabs
|
||||||
|
|||||||
@@ -12,17 +12,8 @@ Below is a list of commonly asked questions with answers sourced from the
|
|||||||
General
|
General
|
||||||
*******
|
*******
|
||||||
|
|
||||||
What is |CL|?
|
Why did you make another distro?
|
||||||
=============
|
================================
|
||||||
|
|
||||||
|CL| is an open source, rolling release Linux distribution optimized for
|
|
||||||
performance and security. See `the about page <https://clearlinux.org/about>`_
|
|
||||||
for more information.
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
Why another Linux distribution?
|
|
||||||
===============================
|
|
||||||
|
|
||||||
The |CL| team felt that performance was left on the table with Linux software.
|
The |CL| team felt that performance was left on the table with Linux software.
|
||||||
|CL| takes a holistic approach to improve performance across the stack. We
|
|CL| takes a holistic approach to improve performance across the stack. We
|
||||||
@@ -30,23 +21,15 @@ also wanted to take more modern approaches with OS updates and tooling.
|
|||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
Is it a derivative of another Linux distribution?
|
Can other distros copy |CL| improvements?
|
||||||
=================================================
|
=========================================
|
||||||
|
|
||||||
No. |CL| is a new Linux distribution. It is not a fork and does not have a
|
|
||||||
parent Linux distribution.
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
Can others copy improvements from |CL|?
|
|
||||||
=======================================
|
|
||||||
|
|
||||||
Yes, we absolutely love open source reuse and upstreaming improvements.
|
Yes, we absolutely love open source reuse and upstreaming improvements.
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
How often does it update?
|
How often do you update?
|
||||||
=========================
|
========================
|
||||||
|
|
||||||
The |CL| team puts out multiple releases a week, often releasing two or more
|
The |CL| team puts out multiple releases a week, often releasing two or more
|
||||||
times a day. This rolling release approach allows |CL| to remain agile to
|
times a day. This rolling release approach allows |CL| to remain agile to
|
||||||
@@ -60,16 +43,15 @@ Is telemetry required?
|
|||||||
The telemetry solution provided by |CL| is entirely optional and customizable.
|
The telemetry solution provided by |CL| is entirely optional and customizable.
|
||||||
It is disabled by default. If you do choose to enable telemetry, the data
|
It is disabled by default. If you do choose to enable telemetry, the data
|
||||||
helps the |CL| team proactively identify and resolve bugs. See the
|
helps the |CL| team proactively identify and resolve bugs. See the
|
||||||
:ref:`telemetry <telem-guide>` guide for more information.
|
:ref:`telem-guide` guide for more information.
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
What is the default firewall?
|
What is the default firewall?
|
||||||
=============================
|
=============================
|
||||||
|
|
||||||
|CL| packages :command:`iptables` and :command:`firewalld` as optional
|
|CL| packages :command:`iptables` as a bundle, however, there are no default
|
||||||
bundles, however, there are no default firewall rules. All network traffic is
|
firewall rules. All network traffic is allowed by default.
|
||||||
allowed by default.
|
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
@@ -78,35 +60,21 @@ Where are the files that I usually see under /etc like fstab?
|
|||||||
|
|
||||||
|CL| has a stateless design that maintains a separation between system files
|
|CL| has a stateless design that maintains a separation between system files
|
||||||
and user files. Default values are stored under :file:`/usr/share/defaults/`.
|
and user files. Default values are stored under :file:`/usr/share/defaults/`.
|
||||||
|CL| starts with a mostly empty :file:`/etc` directory to store user-defined
|
Files under :file:`/etc/` are not created unless you create one.
|
||||||
configurations. See the :ref:`stateless <stateless>` page for more information.
|
|
||||||
|
|
||||||
See `this blog post
|
|
||||||
<https://clearlinux.org/news-blogs/where-etcfstab-clear-linux>`_ for an
|
|
||||||
example explaining how this is accomplished with :file:`/etc/fstab/`
|
|
||||||
specifically.
|
|
||||||
|
|
||||||
|
A blog post explaining how this is accomplished with :file:`/etc/fstab/`
|
||||||
|
specifically is available here:
|
||||||
|
https://clearlinux.org/news-blogs/where-etcfstab-clear-linux
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
Does it use the Intel Compiler (icc)?
|
Software packages
|
||||||
=====================================
|
*****************
|
||||||
|
|
||||||
No. |CL| uses open source compilers: :command:`gcc` and :command:`clang`. |CL|
|
|
||||||
does not compile any packages with :command:`icc`.
|
|
||||||
|
|
||||||
For a more detailed explanation, see `this discussion on the community forum
|
|
||||||
<https://community.clearlinux.org/t/does-clear-linux-os-use-the-intel-compiler-icc-tl-nope/>`_.
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
Software
|
|
||||||
********
|
|
||||||
|
|
||||||
How is software installed and updated?
|
How is software installed and updated?
|
||||||
======================================
|
======================================
|
||||||
|
|
||||||
|CL| provides software in the form of :ref:`bundles <bundles-guide>` and
|
|CL| provides software in the form of :ref:`bundles-guide` and
|
||||||
updates software with :ref:`swupd <swupd-guide>`.
|
updates software with :ref:`swupd <swupd-guide>`.
|
||||||
|
|
||||||
:ref:`Flatpak\* <flatpak-tutorial>` is an application virtualization solution
|
:ref:`Flatpak\* <flatpak-tutorial>` is an application virtualization solution
|
||||||
@@ -118,29 +86,15 @@ bundles whenever possible.
|
|||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
Does it use RPMs or DEBs packages like other distros?
|
Does |CL| use RPMs like other distros?
|
||||||
=====================================================
|
======================================
|
||||||
|
|
||||||
No. |CL| provides software to systems in the form of :ref:`bundles-guide`.
|
|CL| provides software in the form of :ref:`bundles-guide`. The RPM
|
||||||
Under the hood, |CL| developers use the RPM format as an intermediary step for
|
format is used as an intermediary step for packaging and determining software
|
||||||
packaging and determining software dependencies at OS build time.
|
dependencies at OS build time.
|
||||||
|
|
||||||
Individual RPMs and DEBs can sometimes be manually extracted and installed on
|
|
||||||
a |CL| system with the right tools, but that is not the intended use case.
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
||||||
Why does it have a different approach to software management?
|
|
||||||
=============================================================
|
|
||||||
|
|
||||||
The |CL| team wants software *installation* and *updates* to be as efficient
|
|
||||||
and error free as possible. |CL| packages software differently and uses a
|
|
||||||
novel updater to solve some of the classic problems with how the software
|
|
||||||
packages are on Linux.
|
|
||||||
|
|
||||||
For a more detailed explanation, see `this discussion on our community forum
|
|
||||||
<https://community.clearlinux.org/t/why-does-clearlinux-use-swupd-and-not-apt-deb-rpm/>`_.
|
|
||||||
|
|
||||||
|
Individual RPMs can sometimes be manually installed on a |CL| system with the
|
||||||
|
right tools, but that is not the intended use case.
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
@@ -173,9 +127,8 @@ Is Google\* Chrome\* available?
|
|||||||
The Google Chrome web browser is not distributed as a bundle in |CL| due to
|
The Google Chrome web browser is not distributed as a bundle in |CL| due to
|
||||||
copyright and licensing complexities.
|
copyright and licensing complexities.
|
||||||
|
|
||||||
A `discussion on manually installing and maintaining Google Chrome
|
A discussion on manually installing and maintaining Google Chrome can be found
|
||||||
<https://github.com/clearlinux/distribution/issues/422>`_ can be found on
|
on GitHub: https://github.com/clearlinux/distribution/issues/422
|
||||||
GitHub.
|
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
@@ -189,17 +142,13 @@ the `software store`_. Installing Flatpak apps is also covered in our
|
|||||||
The |CL| team is working on a natively packaged version of Visual Studio Code
|
The |CL| team is working on a natively packaged version of Visual Studio Code
|
||||||
for future release.
|
for future release.
|
||||||
|
|
||||||
Join a community `forum discussion about manually installing and maintaining
|
Join a community forum discussion about manually installing and maintaining
|
||||||
Visual Studio Code
|
Visual Studio Code: https://community.clearlinux.org/t/need-native-support-for-vs-code-through-swupd/
|
||||||
<https://community.clearlinux.org/t/need-native-support-for-vs-code-through-swupd/>`_.
|
|
||||||
|
|
||||||
|
|
||||||
.. _VS Code: https://clearlinux.org/software?search_api_fulltext=vscode
|
.. _VS Code: https://clearlinux.org/software?search_api_fulltext=vscode
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
.. _licensing_restrict:
|
|
||||||
|
|
||||||
Is FFmpeg available?
|
Is FFmpeg available?
|
||||||
====================
|
====================
|
||||||
|
|
||||||
@@ -210,12 +159,13 @@ various media encoding/decoding, streaming, and playback.
|
|||||||
complexities (See https://www.ffmpeg.org/legal.html and
|
complexities (See https://www.ffmpeg.org/legal.html and
|
||||||
http://blog.pkh.me/p/13-the-ffmpeg-libav-situation.html).
|
http://blog.pkh.me/p/13-the-ffmpeg-libav-situation.html).
|
||||||
|
|
||||||
|
Read more in the |CL| repository, including discussion of an alternative
|
||||||
|
hardware-based solution:
|
||||||
|
https://github.com/clearlinux/distribution/issues/429.
|
||||||
|
|
||||||
While |CL| cannot distribute FFmpeg, solutions for manually building and
|
While |CL| cannot distribute FFmpeg, a manual solution to build and install
|
||||||
installing FFmpeg have been shared by users `on GitHub
|
FFmpeg under :file:`/usr/local` has been shared on the community forums:
|
||||||
<https://github.com/clearlinux/distribution/issues/429>`_ and `the community
|
https://community.clearlinux.org/t/how-to-h264-etc-support-for-firefox-including-ffmpeg-install.
|
||||||
forums
|
|
||||||
<https://community.clearlinux.org/t/how-to-h264-etc-support-for-firefox-including-ffmpeg-install>`_.
|
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
@@ -226,8 +176,8 @@ ZFS is not available with |CL| because of copyright and licensing
|
|||||||
complexities. BTRFS is an alternative filesystem that is available in |CL|
|
complexities. BTRFS is an alternative filesystem that is available in |CL|
|
||||||
natively.
|
natively.
|
||||||
|
|
||||||
A user on GitHub notes that the `ZFS kernel module can be compiled, built, and
|
A user on GitHub notes that the ZFS kernel module can be compiled, built, and
|
||||||
installed manually <https://github.com/clearlinux/distribution/issues/631>`_.
|
installed manually: https://github.com/clearlinux/distribution/issues/631
|
||||||
|
|
||||||
|
|
|
|
||||||
|
|
||||||
|
|||||||
|
Before Width: | Height: | Size: 283 KiB |
|
Before Width: | Height: | Size: 214 KiB |
|
Before Width: | Height: | Size: 201 KiB |
|
Before Width: | Height: | Size: 194 KiB |
|
Before Width: | Height: | Size: 269 KiB |
|
Before Width: | Height: | Size: 219 KiB |
|
Before Width: | Height: | Size: 202 KiB |
|
Before Width: | Height: | Size: 214 KiB |
|
Before Width: | Height: | Size: 231 KiB |
|
Before Width: | Height: | Size: 190 KiB |
|
Before Width: | Height: | Size: 168 KiB |
|
Before Width: | Height: | Size: 192 KiB |
|
Before Width: | Height: | Size: 224 KiB |
|
Before Width: | Height: | Size: 197 KiB |
|
Before Width: | Height: | Size: 293 KiB |
|
Before Width: | Height: | Size: 296 KiB |
|
Before Width: | Height: | Size: 210 KiB |
|
Before Width: | Height: | Size: 221 KiB |
|
Before Width: | Height: | Size: 223 KiB |
|
Before Width: | Height: | Size: 213 KiB |
|
Before Width: | Height: | Size: 222 KiB |
|
Before Width: | Height: | Size: 283 KiB |
|
Before Width: | Height: | Size: 275 KiB |
|
Before Width: | Height: | Size: 308 KiB |
|
Before Width: | Height: | Size: 258 KiB |
|
Before Width: | Height: | Size: 283 KiB |
|
Before Width: | Height: | Size: 255 KiB |
|
Before Width: | Height: | Size: 232 KiB |
|
Before Width: | Height: | Size: 283 KiB |
|
Before Width: | Height: | Size: 189 KiB |
|
Before Width: | Height: | Size: 172 KiB |
|
Before Width: | Height: | Size: 194 KiB |
|
Before Width: | Height: | Size: 269 KiB |
|
Before Width: | Height: | Size: 191 KiB |
|
Before Width: | Height: | Size: 178 KiB |
|
Before Width: | Height: | Size: 186 KiB |
|
Before Width: | Height: | Size: 202 KiB |
|
Before Width: | Height: | Size: 159 KiB |
|
Before Width: | Height: | Size: 168 KiB |
|
Before Width: | Height: | Size: 192 KiB |
|
Before Width: | Height: | Size: 224 KiB |
|
Before Width: | Height: | Size: 167 KiB |
|
Before Width: | Height: | Size: 287 KiB |
|
Before Width: | Height: | Size: 278 KiB |
|
Before Width: | Height: | Size: 185 KiB |
|
Before Width: | Height: | Size: 201 KiB |
|
Before Width: | Height: | Size: 195 KiB |
|
Before Width: | Height: | Size: 191 KiB |
|
Before Width: | Height: | Size: 199 KiB |
|
Before Width: | Height: | Size: 274 KiB |
|
Before Width: | Height: | Size: 249 KiB |
|
Before Width: | Height: | Size: 308 KiB |
|
Before Width: | Height: | Size: 254 KiB |
|
Before Width: | Height: | Size: 274 KiB |
|
Before Width: | Height: | Size: 227 KiB |
|
Before Width: | Height: | Size: 218 KiB |
|
Before Width: | Height: | Size: 91 KiB After Width: | Height: | Size: 88 KiB |
|
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 69 KiB |
|
Before Width: | Height: | Size: 69 KiB After Width: | Height: | Size: 85 KiB |
|
Before Width: | Height: | Size: 85 KiB After Width: | Height: | Size: 41 KiB |
|
Before Width: | Height: | Size: 47 KiB After Width: | Height: | Size: 30 KiB |
|
Before Width: | Height: | Size: 104 KiB After Width: | Height: | Size: 94 KiB |
|
Before Width: | Height: | Size: 78 KiB |
|
Before Width: | Height: | Size: 18 KiB |
|
Before Width: | Height: | Size: 71 KiB |
|
Before Width: | Height: | Size: 31 KiB |
|
Before Width: | Height: | Size: 31 KiB |
|
Before Width: | Height: | Size: 27 KiB |
|
Before Width: | Height: | Size: 26 KiB |
|
Before Width: | Height: | Size: 69 KiB |
|
Before Width: | Height: | Size: 95 KiB |
|
Before Width: | Height: | Size: 44 KiB |
|
Before Width: | Height: | Size: 27 KiB |
|
Before Width: | Height: | Size: 41 KiB |
|
Before Width: | Height: | Size: 30 KiB |
|
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 24 KiB |
|
Before Width: | Height: | Size: 24 KiB |
|
Before Width: | Height: | Size: 22 KiB After Width: | Height: | Size: 61 KiB |
|
Before Width: | Height: | Size: 11 KiB |
|
Before Width: | Height: | Size: 19 KiB After Width: | Height: | Size: 7.9 KiB |
|
Before Width: | Height: | Size: 9.7 KiB |
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 7.4 KiB |
|
Before Width: | Height: | Size: 7.2 KiB |
|
Before Width: | Height: | Size: 26 KiB After Width: | Height: | Size: 13 KiB |
|
Before Width: | Height: | Size: 13 KiB |
|
Before Width: | Height: | Size: 24 KiB After Width: | Height: | Size: 14 KiB |
|
Before Width: | Height: | Size: 15 KiB |
|
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 25 KiB |
|
Before Width: | Height: | Size: 21 KiB |
|
Before Width: | Height: | Size: 34 KiB After Width: | Height: | Size: 19 KiB |
|
Before Width: | Height: | Size: 15 KiB |
|
Before Width: | Height: | Size: 61 KiB After Width: | Height: | Size: 24 KiB |
|
Before Width: | Height: | Size: 30 KiB |