ReText est un éditeur simple mais puissant pour les langages de balisage Markdown et reStructuredText.

ReText/Archlinux

Installation

Retext est disponible dans les dépôts

yay -S retext python-pyqt6-webengine

python-pyqt6-webengine : moteur de prévisualisation plus puissant avec prise en charge de JavaScript

Alternative : Installation via python pip

Configuration

La configuration est dans le dossier utilisateur $HOME/.config/ReText\ project/ et contient 3 fichiers

1. ReText.conf : Fichier de configuration de base
2. retext.qss : Pour la configuration graphique de l’éditeur
3. markdown-taupe.css : Thème de la prévisualisation

ReText.conf

[General]
appStyleSheet=/home/yann/.config/ReText project/retext.qss
recentFileList=
styleSheet=/home/yann/.config/ReText project/markdown-taupe.css
useWebEngine=true
useWebKit=true

retext.qss

QTextEdit {
  color: black;
  background-color: white;
}

markdown-taupe.css

body {
  font-family: Helvetica, Arial, sans-serif;
  font-size: 15px;
  line-height: 1.3;
  color: #f6e6cc;
  width: 700px;
  margin: auto;
  background: #27221a;
  position: relative;
  padding: 0 30px;
}
body>:first-child
{
  margin-top:0!important;
}
img {
  max-width: 100%;
}
table {
  width: 100%;
  border-collapse: collapse;
}
th {
  background-color: rgba(0, 0, 0, 0.3);
}
table, th, td {
  padding: 5px;
  border: 1px solid rgba(0, 0, 0, 0.3);
  border-radius: 0.4em;
  -moz-border-radius: 0.4em;
  -webkit-border-radius: 0.4em;
}
tr:nth-child(even) {
  background-color: rgba(0, 0, 0, 0.3);
}
p, ul, ol, dl, table, pre {
  margin-bottom: 1em;
}
ul {
  margin-left: 20px;
}
a {
  text-decoration: none;
  cursor: pointer;
  color: #ba832c;
  font-weight: bold;
}
a:focus {
  outline: 1px dotted;
}
a:visited {}
a:hover, a:focus {
  color: #d3a459;
  text-decoration: none;
}
a *, button * {
  cursor: pointer;
}
hr {
  display: none;
}
small {
  font-size: 90%;
}
input, select, button, textarea, option {
  font-family: Arial, "Lucida Grande", "Lucida Sans Unicode", Arial, Verdana, sans-serif;
  font-size: 100%;
}
button, label, select, option, input[type=submit] {
  cursor: pointer;
}
sup {
  font-size: 80%;
  line-height: 1;
  vertical-align: super;
}
h1, h2, h3, h4, h5, h6 {
  line-height: 1.1;
  font-family: Baskerville, "Goudy Old Style", "Palatino", "Book Antiqua", serif;
}
h1 {
  font-size: 24pt;
  margin: 1em 0 0.1em;
}
h2 {
  font-size: 22pt;
}
h3 {
  font-size: 20pt;
}
h4 {
  font-size: 18pt;
}
h5 {
  font-size: 16pt;
}
h6 {
  font-size: 14pt;
}
h1 a, h1 a:hover {
  color: #d7af72;
  font-weight: normal;
  text-decoration: none;
}
::selection {
  background: #745626;
}
::-moz-selection {
  background: #745626;
}
pre {
  background: #1B1812;
  color: #fff;
  padding: 8px 10px;
  overflow-x: hidden;
}
pre code {
  font-size: 10pt;
}

Configurations (en)

ReText stores all of its configuration in a text file: ~/.config/ReText project/ReText.conf.
See the possible configuration options

You can change

• the theme of the window, using Qt stylesheets.
  Add appStyleSheet=/home/YOUR_USERNAME/.config/ReText project/YOUR_FILE.qss to the configuration file

  Example (retext.qss):

  QTextEdit {
    color: black;
    background-color: white;
  }
  

• the color scheme of the text editor, using a [ColorScheme] section in the configuration file

  Example (ReText.conf):

  [ColorScheme]
  htmlTags=green
  htmlSymbols=#ff8800
  htmlComments=#abc
  

• the color scheme of the preview, using CSS.
  Add styleSheet=/home/YOUR_USERNAME/.config/ReText project/YOUR_FILE.css
  and useWebKit=true to the configuration file

  Example (preview.css):

  body {
    color: black;
    background-color: white;
  }
  

Of course, don’t forget to put the files in that directory, then restart ReText to see the changes.

Configuration Options (en)

ReText stores all of its configuration in a text file. A path to that file is printed to stdout during ReText startup.

Configuration options that you can set to improve your experience:

If the type is ‘file path’, then the value should be an absolute path to a file.

These options can be set internally by ReText and should never be set manually: recentFileList, lastFileList, lastTabIndex and windowGeometry.

Icon themes

If ReText starts and does not show icons, go to Preferences dialog and fill the “icon theme” field with the icon theme being used.

By default Qt (the toolkit used by ReText) can correctly detect icon theme only on KDE and on a fixed list of Gtk+-based environments (when the gtk platformtheme is used).

If you don’t know name of your icon theme, look at the names of subdirectories in /usr/share/icons/ directory.

Color scheme setting

It is possible to configure ReText highlighter to use custom colors set, by providing these colors in a separate section in the configuration file.

The example of such section is:

[ColorScheme]
htmlTags=green
htmlSymbols=#ff8800
htmlComments=#abc

Color names for the text editor:

Color names for the highlighter:

Prebuild Color Schemes (en)

Theme	CSS	QSS	Conf	Preview	Source
Default	⨯	⨯	⨯		retext-project
Github	✓	⨯	✓		EndangeredMassa
QDarkStyle	✓	✓	✓		snailhome
Monokai	⨯	✓	✓		geekthis
Monokai Minimal	⨯	✓	✓		geekthis
Solarized	⨯	✓	✓		geekthis
Solarized Light	⨯	✓	✓		geekthis
Breeze Dark	✓	✓	✓		cognifloyd
Markdown Taupe	✓	⨯	⨯		jasonm23
Houdini	✓	✓	✓		shotgunsoftware
Markdown	✓	⨯	⨯		elclanrs