-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hello All,

This is a Windows How-To for installing AsciiDoc without affecting the
Host OS WSJT-X Development environment. Setup time on my hardware was
=< 20 minutes, including download time. I used the oldest HW / SW
combination I have. This works on Windows 32 && 64 bit.

User Guide build time was right at 1.5 minutes running completely
(including Cygwin itself) from the USB Key, and about 22.3 seconds
from HD.


## TESTING HARDWARE - 5+ yrs old
Dell-400 Laptop
OS: WinXP 32-bit
CPU: 1x Core 1.6Ghz Pentium-M
RAM: 768 MB
GPU: 14" i915 Xga
HD: 512MB USB key 5+ yrs old also
Note: Final set up came in at ~262MB with AsciiDoc installed.


## INSTALL Notepad++
* http://download.tuxfamily.org/notepadplus/6.5.3/npp.6.5.3.Installer.exe
* After install, Go-To: Setting >> Preferences >> New Documents
* Select: Format = Unix/OSx, Encoding = ANSI and Def Language = Normal
Test.


## INSTALL Cygwin
* http://cygwin.com/install.html and select 32 or 64 bit.
* Saving the Installer to Desktop makes updating quick & easy.
* Run the installer
* Select Install from Internet, then next
* Root Directory, C:\cygwin .. select All Users, then next
* Local Package Dir: I used c:\cydownloads
* Direct Connection, then next
* I use ftp://mirrors.kernel.org  .. select your fastest DL, then next

* Search, then set to install, just main packages not modules:
- - python >> Interpreters: Python Language interpreter
- - mercurical >> Devel >> Python based DVCS
- - subversion >> Devel >> A Version Control System
- - source-highlight >> Text >> Syntax highlighting utilities
- - openssh >> Net >> The OpenSSH server and client programs
- - nano >> Editors >> Enhanced clone of Pico editor
- - ncurses >> Utils >> Utilities for terminal handling

* Then, next to start installation
* At Create Icons, I select desktop only.


## CHECK INSTALLED PACKAGES
* Open Cygwin Terminal Short cut.
* If "clear" works, ncurses is installed:
clear
python -V
svn --version |head -n1
hg --version |head -n1
ssh -V
source-highlight --version |head -n1
nano --version |head -n1

* If any errors are reported, Do Not Continue Until Resolved!!


## CONFIGURE BASH && MAKE DIRECTORIES
* Edit ./.bash_profile, uncomment if statement:
nano ./.bash_profile

* Change too:
if [ -d "$HOME/bin" ] ; then
   PATH="$HOME/bin:$PATH"
fi

* Ctrl+X to exit, Y, then Enter to save
* Create directories, source .bash_profile, check $PATH:
mkdir -p $HOME/bin $HOME/Projects/documentation/wsjtx
source ./.bash_profile
echo $PATH

* You should see /home/$USER/bin at the beginning of the string.


## CONFIGURE NOTEPAD++ ALIAS
* Add alias, ( all on one line, or edit manually )

echo alias npp='cygstart /cygdrive/c/Program\
Files/Notepad++/notepad++.exe' >> ~/.bashrc

* To test, type: npp <enter>  should open up Notepad++, close and
continue in the terminal.


## INSTALL ASCIIDOC
cd $HOME/bin
hg clone -r 8.6.9 https://asciidoc.googlecode.com/hg/ asciidoc-8.6.9
cd asciidoc-8.6.9 && hg pull && hg update && cd ..
ln -s ~/bin/asciidoc-8.6.9/asciidoc.py ~/bin/asciidoc
asciidoc --version

Should Return: asciidoc 8.6.9


## POST INSTALL WSJT-X DOCS BUILD
cd ~/Projects/documentation/wsjtx

* Note: This pulls "just" the Documentation Tree, without History
svn export svn://svn.berlios.de/wsjt/branches/wsjtx/doc
cd ./doc
./build-doc.sh toc2

* Open wsjtx-main-toc.html, command line, or browse to the folder, then:
cygstart chrome wsjtx-main-toc2.html
cygstart firefox wsjtx-main-toc2.html

If you have any problems, send me a note, I'm sure we can sort it out.

73's
Greg, KI7MT
[email protected]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBAgAGBQJS6QsAAAoJEAmfcyeKlj0x2G0H/jlhT1Sn2L0lLN36V6i0Bses
9FyjTU1lWYxm9P1b0PeY5YorUcp6wypaMI8NDxDht3iryO59ko9gItiVEpIkCUq2
27+Cb3I5k3GR85hxc6ajMl5Dhg+O2SDxUdDQD8kpry6WBSrixOqXkhkUK+83IFDn
1kaOc412hKjZ+20iga5PkzgfP3bwEMt2eRKrdPjygBMOzj4CiAxKqLm2bxwECliu
LXUb+6GPTCL2vF8WEZ8ACT1qdD9IQg7kVLZGu6fS47yB+sWfNZaiIX/oCQ4c3/v8
1wQkbGSxnj9ZUupn5bL8e/tkthQk4HqWPxY7ueMurmHsbbLDvyzVGH/dLbYGO1M=
=Wqnk
-----END PGP SIGNATURE-----
_______________________________________________
Wsjt-devel mailing list
[email protected]
https://lists.berlios.de/mailman/listinfo/wsjt-devel

Reply via email to