From 522f3be031226368079c653da0b003b5904fef1a Mon Sep 17 00:00:00 2001 From: Marta Matvii Date: Mon, 11 Mar 2024 16:27:24 +0200 Subject: [PATCH 1/2] autoformat --- doc/doc/user-manual.rst | 54 +++++++++++++++++++---------------------- 1 file changed, 25 insertions(+), 29 deletions(-) diff --git a/doc/doc/user-manual.rst b/doc/doc/user-manual.rst index be15ba07..4c1b29b5 100644 --- a/doc/doc/user-manual.rst +++ b/doc/doc/user-manual.rst @@ -6,6 +6,9 @@ Nuitka User Manual #################### +This page is the recommended first read when you start using **Nuitka**. +On this page, you will learn more about **Nuitka** fundamentals, such as +license type, use cases, requirements, and credits. This page is the recommended first read when you start using **Nuitka**. On this page, you will learn more about **Nuitka** fundamentals, such as license type, use cases, requirements, and credits. @@ -54,43 +57,36 @@ compiler for C++03 [#]_. Currently, this means, you need to use one of these compilers: -- The MinGW64 C11 compiler, on Windows, must be based on gcc 11.2 or - higher. It will be *automatically* downloaded if no usable C compiler - is found, which is the recommended way of installing it, as Nuitka - will also upgrade it for you. - -- Visual Studio 2022 or higher on Windows [#]_. English language pack - for best results (Nuitka filters away garbage outputs, but only for - English language). It will be used by default if installed. +- The **MinGW64 C11** compiler must be based on **gcc 11.2** or higher. + It will be automatically downloaded if no usable C compiler is found, + which is the recommended way of installing it, as Nuitka will also + upgrade it for you. -- On all other platforms, the ``gcc`` compiler of at least version 5.1, - and below that the ``g++`` compiler of at least version 4.4 as an - alternative. +- The **Community** edition of `Visual Studio 2022 + `_ + or higher. Older versions will work, but only supported for + commercial users. Use the default English language pack to enable + **Nuitka** to filter away irrelevant outputs. -- The ``clang`` compiler on macOS X and most FreeBSD architectures. - -- On Windows, the ``clang-cl`` compiler on Windows can be used if - provided by the Visual Studio installer. - -.. [#] +- The **Clang-cl** compiler can be used if provided by the **Visual + Studio** installer. - Support for this C11 is given with gcc 5.x or higher or any clang - version. +**For macOS**, use the **Clang** compiler. It's also compatible with +most **FreeBSD** architectures. - The older MSVC compilers don't do it yet. But as a workaround, with - Python 3.10 or older, the C++03 language standard is significantly - overlapping with C11, it is then used instead. +**For other platforms**, use the **GCC** compiler of at least version +5.1, and below that the **G++** compiler of at least version 4.4 as an +alternative. .. [#] - Download for free from - https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx - (the community editions work just fine). + Support for this **C11** is given with **gcc 5.x** or higher or any + **clang** version. - The latest version is recommended, but not required. On the other hand, - there is no need to except to support pre-Windows 10 versions, and they - might work for you, but support of these configurations is only - available to commercial users. + The **MSVC** compiler doesn't do it yet. But as a workaround, as the + C++03 language standard is significantly overlapping with C11, it is + then used instead where the C compiler is too old. Nuitka used to + require a C++ compiler in the past, but it changed. Python ====== From 987e20e25d5dc727be8f9211486303683dbfa67e Mon Sep 17 00:00:00 2001 From: Marta Matvii Date: Mon, 18 Mar 2024 16:21:18 +0200 Subject: [PATCH 2/2] Modifies the Share buttons and added the missing link to the Nuitka logo (we accidentally deleted it with the home icon last time) --- _static/facebook.svg | 1 + _static/mastodon.svg | 1 + _static/my_theme.css | 47 ++++++++++++++++++++++++++++---- _static/reddit.svg | 1 + _static/x-twitter.svg | 1 + _templates/footer.html | 16 +++++------ doc/doc/contribute-to-nuitka.rst | 2 +- doc/doc/user-manual.rst | 24 ++-------------- update.py | 1 + 9 files changed, 58 insertions(+), 36 deletions(-) create mode 100644 _static/facebook.svg create mode 100644 _static/mastodon.svg create mode 100644 _static/reddit.svg create mode 100644 _static/x-twitter.svg diff --git a/_static/facebook.svg b/_static/facebook.svg new file mode 100644 index 00000000..d0174fe5 --- /dev/null +++ b/_static/facebook.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/_static/mastodon.svg b/_static/mastodon.svg new file mode 100644 index 00000000..8a126146 --- /dev/null +++ b/_static/mastodon.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/_static/my_theme.css b/_static/my_theme.css index aa3fc7d7..709548d3 100644 --- a/_static/my_theme.css +++ b/_static/my_theme.css @@ -177,8 +177,9 @@ html { transition: opacity 500ms; -webkit-transition: opacity 500ms; color: #fff; + font-size: 12px; text-align: center; - margin-top: 7px; + font-weight: bold; } .social-button:hover .shares { @@ -197,23 +198,59 @@ html { } .social-button.twitter { - background-color: #5BC2F0; + background-color: #fff; border-radius: 25px; + border: 1px solid black; +} + +.social-button.twitter:hover { + background-color: #000; +} + +.social-button.twitter:hover .icon img { + filter: brightness(0) invert(1); } .social-button.mastodon { - background-color: #563ACC; + background-color: #fff; border-radius: 25px; + border: 1px solid #6364FF ; +} + +.social-button.mastodon:hover { + background-color: #6364FF; +} + +.social-button.mastodon:hover .icon img { + filter: brightness(0) invert(1); } .social-button.reddit { - background-color: #333333; + background-color: #fff; border-radius: 25px; + border: 1px solid #FF5700; +} + +.social-button.reddit:hover { + background-color: #FF5700; +} + +.social-button.reddit:hover .icon img { + filter: brightness(0) invert(1); } .social-button.facebook { - background-color: #435D96; + background-color: #fff; border-radius: 25px; + border: 1px solid #1877F2; +} + +.social-button.facebook:hover { + background-color: #1877F2; +} + +.social-button.facebook:hover .icon img { + filter: brightness(0) invert(1); } .language-switcher-container { diff --git a/_static/reddit.svg b/_static/reddit.svg new file mode 100644 index 00000000..6e863ce8 --- /dev/null +++ b/_static/reddit.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/_static/x-twitter.svg b/_static/x-twitter.svg new file mode 100644 index 00000000..21fbe744 --- /dev/null +++ b/_static/x-twitter.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/_templates/footer.html b/_templates/footer.html index 105d3bee..98888bc8 100644 --- a/_templates/footer.html +++ b/_templates/footer.html @@ -7,40 +7,40 @@ diff --git a/doc/doc/contribute-to-nuitka.rst b/doc/doc/contribute-to-nuitka.rst index f8f728f1..2924b8d8 100644 --- a/doc/doc/contribute-to-nuitka.rst +++ b/doc/doc/contribute-to-nuitka.rst @@ -47,4 +47,4 @@ branches: `__ explains the coding rules, branching model used, with feature branches and hotfix releases, the Nuitka design and much more. Consider reading it to - become a contributor. + become a contributor. This document is intended for Nuitka users. diff --git a/doc/doc/user-manual.rst b/doc/doc/user-manual.rst index 4c1b29b5..c9bf9882 100644 --- a/doc/doc/user-manual.rst +++ b/doc/doc/user-manual.rst @@ -18,31 +18,11 @@ license type, use cases, requirements, and credits. :local: :class: page-toc -Nuitka is **the** Python compiler. It is written in Python. It is a -seamless replacement or extension to the Python interpreter and compiles -**every** construct that Python 2 (2.6, 2.7) and Python 3 (3.4 - 3.11) -have, when itself run with that Python version. - -It then executes uncompiled code and compiled code together in an -extremely compatible manner. - -You can use all Python library modules and all extension modules freely. - -Nuitka translates the Python modules into a C level program that then -uses ``libpython`` and static C files of its own to execute in the same -way as CPython does. - -All optimization is aimed at avoiding overhead, where it's unnecessary. -None is aimed at removing compatibility, although slight improvements -will occasionally be done, where not every bug of standard Python is -emulated, e.g. more complete error messages are given, but there is a -full compatibility mode to disable even that. - ************** Requirements ************** -To ensure smooth operation of **Nuitka**, make sure to follow system +To ensure smooth work of **Nuitka**, make sure to follow system requirements, that include the following components: .. contents:: @@ -55,7 +35,7 @@ C Compiler You need a C compiler with support for C11 or alternatively a C++ compiler for C++03 [#]_. -Currently, this means, you need to use one of these compilers: +**For Windows**, use one of the following compilers: - The **MinGW64 C11** compiler must be based on **gcc 11.2** or higher. It will be automatically downloaded if no usable C compiler is found, diff --git a/update.py b/update.py index b56edd73..c5e72b2c 100755 --- a/update.py +++ b/update.py @@ -879,6 +879,7 @@ def runPostProcessing():