From 4e5f670fe9ce535e4ccdca7f2e1b0a3b6008f648 Mon Sep 17 00:00:00 2001 From: ALP Date: Mon, 2 Apr 2018 06:47:14 +0300 Subject: [PATCH 1/3] updated INSTALL.Linux 2 --- INSTALL.Linux | 96 ++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 84 insertions(+), 12 deletions(-) diff --git a/INSTALL.Linux b/INSTALL.Linux index 73a8100b9..45d530251 100644 --- a/INSTALL.Linux +++ b/INSTALL.Linux @@ -11,30 +11,48 @@ etc.), which are described in the 'INSTALL' file. The following is specific to building and installing Dasher on Linux. The Dasher maintainer documentation is at http://live.gnome.org/Dasher. +1) Fork the project from github. + +2) Clone the repo to your machine + + $ git clone https://github.com//dasher.git + $ cd dasher + +4) Install dependencies If you are building sources from the Git repository then you must first install all the packages required to build Dasher. On Debian based distributions the following can be used. - packages="g++ + $ packages="g++ gnome-common gnome-doc-utils libatspi2.0-dev libgtk-3-dev libspeechd-dev" - sudo apt-get install $packages -Then autogen: + $ sudo apt-get install $packages - ./autogen.sh +5) Configuration and Install +autogen: + + $ ./autogen.sh + $ make + $ sudo make instal If the speech support is desired then - ./autogen.sh --enable-speech=yes + $ ./autogen.sh --enable-speech=yes + $ make + $ sudo make install + +6) Run dasher + $/usr/local/bin/dasher + +7) [Optional] Create desktop shortcuts + + $ cd dasher + $ ./create-linux-desktop-shortcuts.sh -After this, follow "Basic Installation" section in the "INSTALL" file. -For the "configure" step, the following configure-time options are -also available (see also the section "`configure' Invocation" in -the "INSTALL" file): Options ======= @@ -81,9 +99,63 @@ Desktop Shortcuts After the installation is done, for Ubuntu and derivatives (e.g., Goobuntu), you can create desktop shortcuts starting Dasher in different profiles by running: - - ./create-linux-desktop-shortcuts.sh + $ cd dasher + $ ./create-linux-desktop-shortcuts.sh The Contributor’s Guide ======================= -If you would like to contribute to this project, please check out the following guide: https://docs.google.com/document/d/1qosKPV0GXbHs69PyvK9BR3S3oNgdV8il7AVfO1M4Fh4 + +Dasher makes use of the GNU autotools system (automake, autoconf +etc.), which are described in the 'INSTALL' file. The following is +specific to building and installing Dasher for contributors on Linux. The Dasher +maintainer documentation is at http://live.gnome.org/Dasher. + +1) Fork the project from github. + +2) Clone the repo to your machine + + $ git clone https://github.com//dasher.git + $ cd dasher + +3) Add the forked repo as the upstream repo + $ git remote add upstream https://github.com/GNOME/dasher.git + + +4) Install dependencies +If you are building sources from the Git repository then you must +first install all the packages required to build Dasher. On Debian +based distributions the following can be used. + + $ packages="g++ + gnome-common + gnome-doc-utils + libatspi2.0-dev + libgtk-3-dev + libspeechd-dev" + + $ sudo apt-get install $packages + +5) Configuration and Install + + $ ./autogen.sh --enable-speech=yes + $ make + $ sudo make install + +6) Run dasher + $/usr/local/bin/dasher + +Syncing Your Fork +================== + +Reference: https://help.github.com/articles/syncing-a-fork/ +1) Fetching latest changes: + $ git fetch upstream +2)Merge latest changes to your local fork repo's master + $ git merge upstream/master +3)Push latest changes to your remote fork repo + $ git push origin master + + + + + From 94dd26d33d1f5e4200d54490846ba451c4901cb9 Mon Sep 17 00:00:00 2001 From: ALP Date: Mon, 2 Apr 2018 16:03:20 +0300 Subject: [PATCH 2/3] updated INSTALL.Linux final --- INSTALL.Linux | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/INSTALL.Linux b/INSTALL.Linux index 45d530251..9001ab4a5 100644 --- a/INSTALL.Linux +++ b/INSTALL.Linux @@ -18,7 +18,7 @@ maintainer documentation is at http://live.gnome.org/Dasher. $ git clone https://github.com//dasher.git $ cd dasher -4) Install dependencies +3) Install dependencies If you are building sources from the Git repository then you must first install all the packages required to build Dasher. On Debian based distributions the following can be used. @@ -32,7 +32,7 @@ based distributions the following can be used. $ sudo apt-get install $packages -5) Configuration and Install +4) Configuration and Install autogen: $ ./autogen.sh @@ -45,14 +45,9 @@ If the speech support is desired then $ make $ sudo make install -6) Run dasher +5) Run dasher $/usr/local/bin/dasher -7) [Optional] Create desktop shortcuts - - $ cd dasher - $ ./create-linux-desktop-shortcuts.sh - Options ======= From 3e462905cab74bb777c5dacdd0af585ec5e59a28 Mon Sep 17 00:00:00 2001 From: ALP Date: Tue, 3 Apr 2018 03:41:24 +0300 Subject: [PATCH 3/3] update Linux.md --- Linux.md | 97 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 Linux.md diff --git a/Linux.md b/Linux.md new file mode 100644 index 000000000..78aee43e0 --- /dev/null +++ b/Linux.md @@ -0,0 +1,97 @@ +--- +title: "Linux" +weight: -100 +--- + +Installation +================== + +Dasher makes use of the GNU autotools system (automake, autoconf +etc.), which are described in the 'INSTALL' file. The following is +specific to building and installing Dasher on Linux. The Dasher +maintainer documentation is at http://live.gnome.org/Dasher. + +1) Fork the project from github. + +2) Clone the repo to your machine +``` + $ git clone https://github.com//dasher.git + $ cd dasher +``` +3) Install dependencies +If you are building sources from the Git repository then you must +first install all the packages required to build Dasher. On Debian +based distributions the following can be used. +``` + $ packages="g++ + gnome-common + gnome-doc-utils + libatspi2.0-dev + libgtk-3-dev + libspeechd-dev" + + $ sudo apt-get install $packages +``` +4) Configuration and Install +autogen: +``` + $ ./autogen.sh + $ make + $ sudo make instal +``` +If the speech support is desired then +``` + $ ./autogen.sh --enable-speech=yes + $ make + $ sudo make install +``` +5) Run dasher +``` + $/usr/local/bin/dasher +``` + +Options +======= + + --disable-speech Disable speech support (speech dispatcher). + + --disable-a11y Disable support for GNOME 2 accessibility features +
(enabled by default). + + --disable-atspi Disable support for GNOME 3 accessibility features +
(enabled by default). +
This flag is just useful + for debugging, as accessibility is now built-in + and doesn't bring in more dependencies. + + + --with-gpe Build binaries for the GPE palmtop environment. + + --with-qte Build binaries using the QTE environment. + +GSettings +========= + +Note that in the GNOME 3 world, GSettings, part of glib, replace +GConf. By default, dasher's "configure" will use GSettings if +found. If not it will use GConf if found. This can be influenced +by the --with-gsettings flag to configure. If on running dasher, +you see + + GLib-GIO-ERROR **: Settings schema 'org.gnome.Dasher' is not installed + aborting... + +try adding the directory which contains "dasher.gschema.xml", +
usually ${prefix}/share/glib-2.0/schemas, to the environment variable +
GSETTINGS_SCHEMA_DIR. + +Desktop Shortcuts +================= +After the installation is done, for Ubuntu and derivatives +(e.g., Goobuntu), you can create desktop shortcuts starting Dasher in +different profiles by running: +``` + $ cd dasher + $ ./create-linux-desktop-shortcuts.sh +``` +