Differences

This shows you the differences between two versions of the page.

--- playground:misc:asciidoc_snippet [2022/04/28 14:49] – [Editing] hc9
+++ playground:misc:asciidoc_snippet [2022/06/14 06:02] (current) – removed hc9
@@ Line 1: / Line 1: @@
-====== asciidoc snippet ======
-|DRAFT: Creating a tutorial with the asciidoc markup format.|
-===== Pico Cheat Sheet =====
-An asciidoc version of the [[:pico_cheat_sheet|Pico Cheat Sheet]] tutorial.
-<file config An asciidoc version of pico.>
-== Pico Cheat Sheet
-**pico** is a simple, display-oriented text editor originally developed for the https://wiki.sdf.org/doku.php?id=email_at_sdf#email_programs_from_shell_membershipsuser_or_arpa_or_metaarpa[pine] e-mail client.
-**pico** is the default editor for SDF's https://wiki.sdf.org/doku.php?id=bboard[bboard] system.
-=== Survival Guide
-image::https://wiki.sdf.org/lib/exe/fetch.php?media=pico-label.png[alt="UW PICO",width=400]
-=== Control Keys
-_(The key sequence_ ++Esc Esc x++ _can be used instead of the combination_ ++Ctrl-x++__).__
-|===
-|Ctrl-A |beginning of line | Ctrl-N | next line
-|Ctrl-B |backward character |Ctrl-O |output file
-|Ctrl-C |cursor position |Ctrl-P |previous line
-|Ctrl-D |delete character |Ctrl-R |read insert file
-|Ctrl-E |end of line |Ctrl-T |spell check
-|Ctrl-F |forward character |Ctrl-U |paste
-|Ctrl-G |get help |Ctrl-V |forward page
-|Ctrl-I |insert tab |Ctrl-W |search
-|Ctrl-J |justify paragraph |Ctrl-X |save exit
-|Ctrl-K |cut region |Ctrl-Y |backward page
-|Ctrl-L |refresh display |Ctrl-$$^$$ |set mark
-|===
-=== Function Keys
-|===
-|F1 |get help |F5 |read insert file |F9 |cut region
-|F2 |save exit |F6 |search |F10 |paste
-|F3 |output file |F7 |backward page |F11 |cursor position
-|F4 |justify paragraph |F8 |forward page |F12 |spell check
-|===
-'''
-$$Source:$$ http://sdf.org/?tutorials/pico
-</file>
-===== HT802 =====
-An asciidoc version of the [[http://sdf.org/?tutorials/ht802_factory_unlock|HT802]] [[wp>Revision_Control_System|RCS]] tutorial.
-<file config An asciidoc version of HT802.>
-== Vonage/Grandstream HT802 Factory Unlock
-#$$WARNING:$$ This is an advanced topic and will void your warranty! Neither SDF, the authors, contributors or sources linked within this file will be liable for your own actions. Proceed with caution!#
-#WARNING 2: This page is provided for information only. Under no circumstances should these instructions be used for any illegal purpose or in violation of any contract or user agreement.#
-Vonage branded models of the Grandstream HT802 come loaded with a factory-locked firmware which does not allow for user configuration. These models will not permit admin login with the standard Grandstream default login of admin/admin. Removing the Vonage settings will require the following tools and abilities:
-* A philips-head screwdriver
-* A computer with a USB port
-* A USB-Serial adapter such as a PL2303 or FTDI and male jumper wires
-* Terminal software cabaple of interacting with a serial console (screen or minicom)
-* Basic hardware hacking knowledge (think raspberry pi GPIO)
-* Common sense
-* An adventurous spirit
-=== Step one: Disassembly and mainboard access
-* Puncture or remove the sticker on the bottom of the device that says "Warranty void if removed". WARNING: This will void your warranty
-* Use a philips-head screwdriver to remove the single screw in the center of the bottom of the case
-* Carefully unclip and remove the top of the case. The clips are very secure, and may require some gentle force to remove.
-* The devices mainboard should now be exposed, you will see the components, including the serial headers labelled below:
-image::http://sdf.org/tutorials/images/ht802_pinout.jpg[alt="HT802 Pinout",width=600]
-Image courtesy of dslreports.com user https://www.dslreports.com/forum/r31157705-[toro]
-=== Step two: Connect to the serial terminal
-* Using male jumper wires, connect the serial headers on the mainboard to the appropriate pins of your USB to serial adapter: Note: Male jumper wires _should_ slip into the through-holes on the mainboard's header. _Do not_ force anything or you may risk damage to the board.
-** RX to TX
-** TX to RX
-** GND to GND
-** DO NOT allow the USB to serial adapter's +5v wire to come into contact with the mainboard, as this may cause damage to the device.
-* Connect the USB to serial adapter to your computer's USB port
-* Use a serial terminal program to access they USB serial port, e.g.:
-----
-screen /dev/ttyUSB0 115200
-----
-* Carefully plug the HT802 into its power source. If you have everything connected properly, you will see boot messages printed to your terminal window. If you do not see this, disconnect everything and start over, carefully.
-=== Step three: Apply unlock and flash firmware
-* Wait for the device to finish boothing. Once it is complete, you should see a root command prompt, indicated by the '#' character.
-* Type the following commands, in order. If at any point you recieve an error, stop, and carefully check your work.
-+
-----
-cd /tmp
-dd if=/dev/mtd1 of=/tmp/fact-old.img
-wget http://shriver.sdf.org/misc/ht802unlock
-chmod +x ht802unlock
-./ht802unlock
-flash_erase /dev/mtd1
-cat /tmp/fact-new.img > /dev/mtd1
-flash_eraseall /dev/mtd2
-----
-* Note: the ht802unlock file is a small program that reads the file fact-old.img and creates a fact-new.img with the Vonage settings removed.
-* At this point you may wish to pause and backup the two files fact-old.img and fact-new.img. Having these will allow you to restore to the factory firmware. You can save these files by doing the following:
-** First, determin the PID of the web server that the firmware is running, using:
-+
-----
-ps w
-----
-** Kill the webserver process:
-+
-----
-kill $PID
-----
-** Start a new webserver in the /tmp directory:
-+
-----
-httpd -h /tmp -p 80
-----
-** Using a web browser on your computer, access and download the following files:
-+
-----
-http://grandstream_ip_address/fact-old.img
-http://grandstream_ip_address/fact-new.img
-----
-* Finally, reboot the device:
-----
-reboot -f
-----
-When your HT802 reboots, you will be able to access the web interface using the device's ip address. The default login admin/admin will allow you to configure the device without factory restrictions.
-These instructions have been adapted from https://www.dslreports.com/forum/r31158266-[this post] on dslreports.com
-</file>
-==== AsciiDoc ====
-asciidoc at the SDF cluster prompt:
-<code>
-$ asciidoc --help syntax | less
-</code>
-  * Save //An_asciidoc_version_of_pico//, as pico_cheat_sheet.adoc
-<code>
-$ asciidoc -s pico_cheat_sheet.adoc
-$ links pico_cheat_sheet.html
-</code>
-  * Save //An_asciidoc_version_HT820//, as ht820.adoc
-<code>
-$ asciidoc -s ht820.adoc
-$ links ht820.html
-</code>
-==== Converter ====
-|**Pandoc** a universal document converter; [[https://pandoc.org/MANUAL.html|Pandoc Manual]]|
-|''pandoc'' [//options//] [//input-file//]…|
-  * Convert the //pico_cheat_sheet.html// file to a //dokuwiki// txt file.
-<code>
-$ pandoc -f html -t dokuwiki pico_cheat_sheet.html -o pico_cheat_sheet.txt
-</code>
-  * Convert the //ht802.html// file to a //dokuwiki// txt file. :!: Needs work/review.
-<code>
-$ pandoc -f html -t dokuwiki ht802.html -o ht802.txt
-</code>
-==== Editing ====
-|[[https://asciidoclive.com/edit/scratch/1|AsciiDocLive (editor)]]|
-^Reference:^
-|[[https://docs.slackware.com/howtos:misc:dokuwiki_versus_asciidoc_markups|dokuwiki versus asciidoc markups; Conversion Table and Cheat Sheet]]|
-|[[https://asciidoctor.org/docs/asciidoc-writers-guide|AsciiDoc Writer’s Guide]]|
-===== asciidoc table =====
-An asciidoc version of the [[:vps_-_plan9front_-_acme_sam_abaco_mothra_and_man#acme|acme]] tutorial section.
-<file config An asciidoc version of acme.>
-== acme
-Start acme to access the mbox.
-----
-% acme
-----
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol**
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol** <= Add _Mail_ by typing ''Mail''.
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol Mail** <= Mouse button 2 press _Mail_.
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol Mail**
-|**_/mail/fs/mbox_** **Del Snarf : Look Put Mail Delmesg Undelmesg Next**
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol Mail**
-|**_/mail/fs/mbox_** **Del Snarf : Look Put Mail Delmesg Undelmesg Next** <= Mouse button 2 press _Mail_ to compose a new mail.
-|1/ <= Email messages arrive here.
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol Mail**
-|**_/mail/fs/mbox_** **Del Snarf : Look Put Mail Delmesg Undelmesg Next**
-|2/ <= Email messages arrive here.
-|1/
-|**_/mail/fs/mbox/Compose.1_** **Del Snarf : Look Post :fmt** <= Mouse button 2 press _Post_ to send the mail; _fmt_ to format the mail.
-|To:
-|Subject:
-|[blank]
-|some text here <= Type the email text here.
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol Mail**
-|**_/mail/fs/mbox_** **Del Snarf : Look Put Mail Delmesg Undelmesg Next**
-|1/ <= Email messages arrive here.
-|**_/mail/fs/mbox/Compose.1_** **Del Snarf : Look Post :fmt** <= Mouse button 2 press _Post_ to send the mail; _fmt_ to format the mail.
-|To:
-|From: <= Type the _From:_ text here.
-|Subject:
-|[blank]
-|some text here <= Type the email text here.
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol Mail**
-|**_/mail/fs/mbox_** **Del Snarf : Look Put Mail Delmesg Undelmesg Next**
-|5/ <= Mouse button 3 press #5 (__/5__) to open the message.
-|4/
-|3/
-|2/
-|1/
-|===
-=== acme 'win'
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol**
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol** <= Add _win_ by typing "win".
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol win** <= Mouse button 2 press _win_.
-|===
-|===
-h|Newcol Kill Putall Dump Exit
-|**New Cut Paste Snarf Sort Zerox Delcol win**
-|**_/usr/$user/-rc_** **Del Snarf : Look Send Noscroll**
-|cpu:
-|===
-</file>
-  * Save //An_asciidoc_version_of_acme//, as acme_table.adoc
-<code>
-$ asciidoc -s acme_table.adoc
-$ links acme_table.html
-</code>