This commit is contained in:
Abdelhakim Qbaich 2017-09-04 06:53:07 +00:00 committed by GitHub
commit b2f8315c23
16 changed files with 402 additions and 52 deletions

View file

@ -2,32 +2,64 @@ find_package(A2X)
if (A2X_FOUND) if (A2X_FOUND)
add_custom_target(man ALL) add_custom_target(man ALL)
function(add_manpage name section)
add_custom_command(
OUTPUT ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${name}.${section}
COMMAND ${A2X_COMMAND}
--no-xmllint
--doctype manpage
--format manpage
-D ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}
${CMAKE_CURRENT_SOURCE_DIR}/${name}.${section}.txt
DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/${name}.${section}.txt
COMMENT Generating manpage for ${name}.${section}
)
add_custom_target(man-${name}.${section}
DEPENDS
${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${name}.${section}
)
add_dependencies(man
man-${name}.${section}
)
install(
FILES ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${name}.${section}
DESTINATION ${CMAKE_INSTALL_FULL_DATAROOTDIR}/man/man${section}
COMPONENT documentation
)
endfunction()
endif() endif()
function(add_manpage name section locale)
if (NOT A2X_FOUND)
return()
endif()
if (${locale} STREQUAL "en")
set(
input
${CMAKE_CURRENT_SOURCE_DIR}/man/${name}.${section}.txt
)
set(
output
${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${name}.${section}
)
set(
destination
${CMAKE_INSTALL_FULL_DATAROOTDIR}/man/man${section}
)
else()
set(
input
${CMAKE_CURRENT_SOURCE_DIR}/man/${name}.${section}.${locale}.txt
)
set(
output
${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${name}.${section}.${locale}
)
set(
destination
${CMAKE_INSTALL_FULL_DATAROOTDIR}/man/${locale}/man${section}
)
endif()
add_custom_command(
OUTPUT ${output}
COMMAND ${A2X_COMMAND}
--no-xmllint
--doctype manpage
--format manpage
-D ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}
${input}
DEPENDS ${input}
COMMENT Generating manpage for ${name}.${section}.${locale}
)
add_custom_target(man-${name}.${section}.${locale}
DEPENDS ${output}
)
add_dependencies(man
man-${name}.${section}.${locale}
)
install(
FILES ${output}
DESTINATION ${destination}
COMPONENT documentation
RENAME ${name}.${section}
)
endfunction()

View file

@ -97,10 +97,14 @@ if (CMAKE_SYSTEM_NAME STREQUAL FreeBSD)
add_config(10-freebsd security.d/10-freebsd sway/security.d) add_config(10-freebsd security.d/10-freebsd sway/security.d)
endif (CMAKE_SYSTEM_NAME STREQUAL FreeBSD) endif (CMAKE_SYSTEM_NAME STREQUAL FreeBSD)
if (A2X_FOUND) add_manpage(sway 1 en)
add_manpage(sway 1) add_manpage(sway 1 ja)
add_manpage(sway 5) add_manpage(sway 1 fr)
add_manpage(sway-input 5) add_manpage(sway 5 en)
add_manpage(sway-bar 5) add_manpage(sway 5 fr)
add_manpage(sway-security 7) add_manpage(sway-input 5 en)
endif() add_manpage(sway-input 5 fr)
add_manpage(sway-bar 5 en)
add_manpage(sway-bar 5 fr)
add_manpage(sway-security 7 en)
add_manpage(sway-security 7 fr)

View file

@ -1,5 +1,5 @@
///// /////
vim:set ts=4 sw=4 tw=82 noet: vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
///// /////
sway-bar (5) sway-bar (5)
============ ============

View file

@ -1,5 +1,5 @@
///// /////
vim:set ts=4 sw=4 tw=82 noet: vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
///// /////
sway-input (5) sway-input (5)
============== ==============

View file

@ -1,5 +1,5 @@
///// /////
vim:set ts=4 sw=4 tw=82 noet: vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
///// /////
sway-security (7) sway-security (7)
================= =================

127
sway/man/sway.1.ja.txt Normal file
View file

@ -0,0 +1,127 @@
/////
vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
/////
:quotes.~:
sway (1)
========
名前
----
sway - SirCmpwnのWaylandのcompositor
書式
----
'sway' [options] [command]
Options
-------
*-h, --help*::
Show help message and quit.
*-c, \--config* <config>::
Specifies a config file.
*-C, \--validate*::
Check the validity of the config file, then exit.
*-d, --debug*::
Enables full logging, including debug information.
*-v, \--version*::
Show the version number and quit.
*-V, --verbose*::
Enables more verbose logging.
*--get-socketpath*::
Gets the IPC socket path and prints it, then exits.
Description
-----------
sway was created to fill the need of an i3-like window manager for Wayland. The
upstream i3 developers have no intention of porting i3 to Wayland, and projects
proposed by others ended up as vaporware. Many thanks to the i3 folks for
providing such a great piece of software, so good that your users would rather
write an entirely new window manager from scratch that behaved _exactly_ like i3
rather than switch to something else.
Launch sway directly from a tty or via your favorite Wayland-compatible login
manager.
Commands
--------
If sway is currently running, you may run _sway [command]_ to send _command_ to
the running instance of sway. The same commands you would use in the config file
are valid here (see **sway**(5)). For compatibility reasons, you may also issue
commands with **swaymsg**(1) or **i3-msg**(1) (or even with **i3**(1), probably).
Configuration
-------------
If _-c_ is not specified, sway will look in several locations for your config
file. The suggested location for your config file is ~/.config/sway/config.
~/.sway/config will also work, and the rest of the usual XDG config locations
are supported. If no sway config is found, sway will attempt to load an i3
config from all the config locations i3 supports. Sway looks for a config file in
a fallback directory as a last resort, which is /etc/sway/ by default. A standard
configuration file is installed at this location. If still nothing is found,
you will receive an error.
To write your own config, it's suggested that you copy the default config file to
the location of your choosing and start there.
For information on the config file format, see **sway**(5).
Environment
-----------
The following environment variables have an effect on sway:
*SWAY_CURSOR_THEME*::
Specifies the name of the cursor theme to use.
*SWAY_CURSOR_SIZE*::
Specifies the size of the cursor to use.
*SWAYSOCK*::
Specifies the path to the sway IPC socket.
*WLC_DRM_DEVICE*::
Specifies the device to use in DRM mode.
*WLC_SHM*::
Set 1 to force EGL clients to use shared memory.
*WLC_OUTPUTS*::
Number of fake outputs to use when running in X11 mode.
*WLC_XWAYLAND*::
Set to 0 to disable Xwayland support.
*WLC_LIBINPUT*::
Set to 1 to force libinput (even in X11 mode).
*WLC_REPEAT_DELAY*::
Configures the keyboard repeat delay.
*WLC_REPEAT_RATE*::
Configures the keyboard repeat rate.
*XKB_DEFAULT_RULES*, *XKB_DEFAULT_MODEL*, *XKB_DEFAULT_LAYOUT*, *XKB_DEFAULT_VARIANT*, *XKB_DEFAULT_OPTIONS*::
Configures the xkb keyboard settings. See xkeyboard-config(7).
Authors
-------
Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other open
source contributors. For more information about sway development, see
<https://github.com/SirCmpwn/sway>.
See Also
--------
**sway**(5) **swaymsg**(1) **swaygrab**(1) **sway-input**(5) **sway-bar**(5)

View file

@ -1,5 +1,5 @@
///// /////
vim:set ts=4 sw=4 tw=82 noet: vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
///// /////
:quotes.~: :quotes.~:

View file

@ -1,5 +1,5 @@
///// /////
vim:set ts=4 sw=4 tw=82 noet: vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
///// /////
sway (5) sway (5)
======== ========

View file

@ -23,6 +23,5 @@ install(
COMPONENT runtime COMPONENT runtime
) )
if (A2X_FOUND) add_manpage(swaygrab 1 en)
add_manpage(swaygrab 1) add_manpage(swaygrab 1 fr)
endif()

View file

@ -1,5 +1,5 @@
///// /////
vim:set ts=4 sw=4 tw=82 noet: vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
///// /////
:quotes.~: :quotes.~:

View file

@ -46,6 +46,5 @@ install(
COMPONENT data COMPONENT data
) )
if (A2X_FOUND) add_manpage(swaylock 1 en)
add_manpage(swaylock 1) add_manpage(swaylock 1 fr)
endif()

View file

@ -0,0 +1,111 @@
/////
vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
/////
:quotes.~:
swaylock (1)
============
Nom
---
swaylock - Écran de verrouillage pour sway.
Synopsis
--------
'swaylock' [options]
Verrouiller la session actuelle de sway.
Options
-------
*-h, --help*::
Affiche le message d'aide et quitte.
*-c, \--color* <rrggbb[aa]>::
Turn l'écran into la couleur donnée. Si -i est utilisé, cela définit
l'arrière-plan de l'image à la couleur donnée. Blanc (ffffff) par défaut, ou
transparent (00000000) si une image est utilisée.
*-i, \--image* [<output>:]<path>::
Affiche l'image donnée, facultativement uniquement sur la sortie donnée.
Utilisez -c pour définir une couleur d'arrière-plan.
*--scaling*::
Mode de mise à l'échelle pour les images : stretch, fill, fit, center, or tile.
*-t, --tiling*::
Semblable à --scaling=tile.
*-u, --no-unlock-indicator*::
Désactive l'indicateur de déverrouillage.
*-v, \--version*::
Affiche le numéro de version et quitte.
*--socket <path>*::
Utilise le chemin de socket spécifié. Sinon, swaymsg demandera à sway où se
trouve le socket (d'abord la valeur de $SWAYSOCK, puis de $I3SOCK).
Apparence
---------
*--bshlcolor* <rrggbb[aa]>::
Définit the color of backspace highlight segments.
*--font* <font>::
Définit the font of the text inside the indicator.
*--insidecolor* <rrggbb[aa]>::
Définit the color of the inside of the indicator when typing or idle.
*--insidevercolor* <rrggbb[aa]>::
Définit the color of the inside of the indicator when verifying.
*--insidewrongcolor* <rrggbb[aa]>::
Définit the color of the inside of the indicator when invalid.
*--keyhlcolor* <rrggbb[aa]>::
Définit the color of keypress highlight segments.
*--linecolor* <rrggbb[aa]>::
Définit the color of the lines that separate the inside and outside of the
indicator.
*-s, \--line-uses-inside*::
Use the color of the inside of the indicator for the line separating the
inside and outside of the indicator.
*-r, \--line-uses-ring*::
Use the outer ring's color for the line separating the inside and outside of
the indicator.
*--ringcolor* <rrggbb[aa]>::
Définit the color of the outside of the indicator when typing or idle.
*--ringvercolor* <rrggbb[aa]>::
Définit the color of the outside of the indicator when verifying.
*--ringwrongcolor* <rrggbb[aa]>::
Définit the color of the outside of the indicator when invalid.
*--separatorcolor* <rrggbb[aa]>::
Définit the color of the lines that seperate highlight segments.
*--textcolor* <rrggbb[aa]>::
Définit the color of the text inside the indicator.
*--indicator-radius* <radius>::
Définit the radius of the indicator to _radius_ pixels. The default value is
50.
*--indicator-thickness* <thickness>::
Définit the thickness of the indicator to _thickness_ pixels. The default value
is 10.
Auteurs
-------
Maintenu par Drew DeVault <sir@cmpwn.com>, assisté par d'autres contributeurs
open source. Pour plus d'information sur le développement de sway, voir
<https://github.com/SirCmpwn/sway>.

View file

@ -1,5 +1,5 @@
///// /////
vim:set ts=4 sw=4 tw=82 noet: vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
///// /////
:quotes.~: :quotes.~:

View file

@ -18,6 +18,5 @@ install(
COMPONENT runtime COMPONENT runtime
) )
if (A2X_FOUND) add_manpage(swaymsg 1 en)
add_manpage(swaymsg 1) add_manpage(swaymsg 1 fr)
endif()

View file

@ -0,0 +1,79 @@
/////
vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
/////
:quotes.~:
swaymsg (1)
===========
Nom
---
swaymsg - Envoyer des messages à une instance en exécution sur le socket IPC.
Synopsis
--------
'swaymsg' [options] [message]
Options
-------
*-h, --help*::
Affiche le message d'aide et quitte.
*-q, \--quiet*::
Envoie le message IPC, mais n'affiche pas la réponse de sway.
*-r, \--raw*::
Utilise la sortie brute (raw) malgré l'utilisation d'un tty.
*-s, --socket* <path>::
Utilise le chemin de socket spécifié. Sinon, swaymsg demandera à sway où se
trouve le socket (d'abord la valeur de $SWAYSOCK, puis de $I3SOCK).
*-t, \--type* <type>::
Spécifie le type du message IPC. Voir ci-dessous.
*-v, \--version*::
Affiche la version (de swaymsg) et quitte.
Types de message IPC
--------------------
*command*::
Le message est une commande sway (les mêmes commandes que vous pouvez lier aux keybindings
dans votre fichier de configuration de sway). Ce sera exécuté immédiatement.
*get_workspaces*::
Obtient une liste d'espaces de travail encodée en JSON et leur statut.
*get_inputs*::
Obtient une liste des entrées actuelles encodée en JSON.
*get_outputs*::
Obtient une liste des sorties actuelles encodée en JSON.
*get_tree*::
Obtient un arbre de layout encodé en JSON de tous les fenêtres ouvertes,
conteneurs, sorties, espaces de travail, etc.
*get_marks*::
Obtient une liste de maques encodée en JSON.
*get_bar_config*::
Obtient une configuration pour swaybar encodée en JSON.
*get_version*::
Obtient des informations sur la version de l'instance de sway
en cours d'exécution, encodée en JSON.
Auteurs
-------
Maintenu par Drew DeVault <sir@cmpwn.com>, assisté par d'autres contributeurs
open source. Pour plus d'information sur le développement de sway, voir
<https://github.com/SirCmpwn/sway>.
Voir aussi
----------
**sway**(5)

View file

@ -1,5 +1,5 @@
///// /////
vim:set ts=4 sw=4 tw=82 noet: vim:set ts=4 sw=4 tw=82 noet ft=asciidoc:
///// /////
:quotes.~: :quotes.~: