mirror of
https://github.com/saitohirga/WSJT-X.git
synced 2024-11-15 16:42:12 -05:00
6ef06bc16f
* mainwindow.cpp - bumped ver# * Updated build-doc.sh: - name changes - array var for electaft - added Build Quick Reference Only option ./build-doc.sh quick-ref * Corrected file ext typo: .ado to .adoc * Started adding material to Quick Reference Guide. ** Tested all (4) build methods, no failures. git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@3671 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
151 lines
3.6 KiB
Plaintext
151 lines
3.6 KiB
Plaintext
// Status=DRAFT
|
|
// this is intentionally left as a single file v.s. multiple sections to allow
|
|
// users to browse the Page Source
|
|
= AsciiDoc Quick Reference
|
|
:Author: WSJT-X Documetation Team
|
|
:Date: January 22, 2014, Copyright © CC-BY-SA 3.0 Unported
|
|
:Revision: 0.0.1
|
|
:badges:
|
|
:icons:
|
|
:numbered:
|
|
:image_dir:
|
|
|
|
// web-links
|
|
:asciidoc_help: http://www.methods.co.nz/asciidoc/userguide.html[ AsciiDoc User Guide ]
|
|
:asciidoc_cheatsheet: http://powerman.name/doc/asciidoc[ AsciiDoc Cheatsheet ]
|
|
:asciidoc_questions: http://www.methods.co.nz/asciidoc/faq.html[ AsciiDoc FAQ ]
|
|
:cc_by_sa: http://creativecommons.org/licenses/by-sa/3.0/[ Commons Attribution-ShareAlike 3.0 Unported License ]
|
|
:devsvn: http://developer.berlios.de/projects/wsjt/[Devel-SVN]
|
|
:download: http://physics.princeton.edu/pulsar/K1JT/wsjtx.html[ Download Page ]
|
|
:homepage: http://physics.princeton.edu/pulsar/K1JT/[ WSJT Home Page ]
|
|
:ntpsetup: http://www.satsignal.eu/ntp/setup.html[Network Time Protocol Setup]
|
|
:wsjtx: http://physics.princeton.edu/pulsar/K1JT/wsjtx.html[ WSJT-X ]
|
|
:page_source: ./source/quick-reference.txt[ Page Source ]
|
|
|
|
// mail-to links
|
|
:stuart_rackman: mailto:srackham@gmail.com[ Stuart Rackham ]
|
|
:alex_efros: mailto:powerman@powerman.name[ Alex Efros ]
|
|
:devmail: mailto:wsjt-devel@lists.berlios.de[WSJT-Devel-List]
|
|
|
|
[[X1]]
|
|
== Introduction
|
|
The purpose of this guide is to provide a quick reference to commonly used
|
|
markup-up items for writing the {wsjtx} User Guide. Additional resources and
|
|
examples can be found at:
|
|
|
|
* {asciidoc_help} by {stuart_rackman}
|
|
* {asciidoc_questions} by {stuart_rackman}
|
|
* {asciidoc_cheatsheet} by {alex_efros}
|
|
|
|
[[X2]]
|
|
== Asciidoc Install
|
|
|
|
For _WSJT-X_ documentation purposes, only (2) dependencies are generally
|
|
required:
|
|
|
|
* Python
|
|
* Source highlight
|
|
|
|
For most packages, the normal method of installation is through their
|
|
respective package manager. There are several reasons why we do not
|
|
want this for the _WSJT-X User Guide_:
|
|
|
|
** Most packaged applications are installed system-wide, which means standard
|
|
pivilaged (non Root / RootSudo) users update their binaries.
|
|
** Often times, distro packages are (1) or more revisions behind.
|
|
** Updating to the latest stable _AscciDoc_ version, using Mercurial, is a simple
|
|
one line command: _hg pull ; hg update ; hg upgrade_, or clone a new binary
|
|
set with _hg clone -r 8.6._ then re-link the new binary.
|
|
** Using $HOME makes working on the _WSJT-X User Guide_ portable, such as,
|
|
installing to a USB Key and allowing you to test build your work on virtually
|
|
any system that has _Python_ {amp}{amp} _Bash Enviroment_ installed.
|
|
|
|
// Several more items pending addition
|
|
_Further Edited Pending_
|
|
|
|
|
|
[[X21]]
|
|
=== Windows
|
|
|
|
Install Instructions:
|
|
|
|
==== Vista, Win7, Win8
|
|
|
|
Install Instructions:
|
|
|
|
[[X22]]
|
|
=== Linux
|
|
|
|
==== Ubuntu, Debian, Mint and relatives
|
|
|
|
Install Instructions:
|
|
|
|
==== RedHat, Fedora, CentOS, and relatives
|
|
|
|
Install Instructions:
|
|
|
|
==== Slackware
|
|
|
|
Install Instructions:
|
|
|
|
==== Linux Other
|
|
|
|
Install Instructions:
|
|
|
|
[[X23]]
|
|
=== OS X
|
|
|
|
Install Instructions:
|
|
|
|
[[X3]]
|
|
== How To Contribute
|
|
.Under Construction
|
|
|
|
=== Blocks
|
|
.Under Construction
|
|
|
|
Content needed.
|
|
|
|
=== Headers
|
|
.Under Construction
|
|
|
|
Content needed.
|
|
|
|
=== Links
|
|
.Under Construction
|
|
|
|
Content needed.
|
|
|
|
=== Lists
|
|
.Under Construction
|
|
|
|
Content needed.
|
|
|
|
=== Notes
|
|
.Under Construction
|
|
|
|
Content needed.
|
|
|
|
[[X36]]
|
|
=== Text
|
|
.Under Construction
|
|
|
|
Content needed.
|
|
|
|
[[XA1]]
|
|
== Appendix A: Credits
|
|
.Authors, Editors, Commiters
|
|
If you worked on the documentation, add yourself to the list.
|
|
|
|
* Authors: <call-sign>, <call-sign>
|
|
|
|
* Editors: <call-sign>, <call-sign>
|
|
|
|
* Commiters: <call-sign>, <call-sign>
|
|
|
|
|
|
== Appendix B: License
|
|
|
|
This work is licensed under {cc_by_sa}.
|
|
|