Skip to content

Commit

Permalink
The Documentation Update (again) (#4056)
Browse files Browse the repository at this point in the history
* Docs update. (#13)

* Update manual.css

* Update HOWTO-microsoft.htm

* Update gtkdialog.htm.

* Move HOWTO_modem.htm->HOWTO_dialup.htm

* Add simple_network_setup docs

* Add scroll_back_button to each file.

* Update root.htm

* Update installation.htm

* Update devx.htm as proposed by bigpup

* Update forums.htm

* Update connaman-gtk docs

* Update release-skeleton.bottom.htm

* Remove HOWTO-regexps.htm

* Update cups_shell.htm

* Finalize cups_shell.htm

* Update HOWTO-multimedia.htm

* Update Pudd.htm

* Docs update. (#13)

* Update manual.css

* Update HOWTO-microsoft.htm

* Update gtkdialog.htm.

* Move HOWTO_modem.htm->HOWTO_dialup.htm

* Add simple_network_setup docs

* Add scroll_back_button to each file.

* Update root.htm

* Update installation.htm

* Update devx.htm as proposed by bigpup

* Update forums.htm

* Update connaman-gtk docs

* Update release-skeleton.bottom.htm

* Remove HOWTO-regexps.htm

* Update cups_shell.htm

* Finalize cups_shell.htm

* Update HOWTO-multimedia.htm

* Update Pudd.htm

* Reduce images' size

* Update petbuild

* Reduce images' (png) size

* Delete HOWTO_Dialup.htm

* Reduce images' size.
  • Loading branch information
lakshayrohila committed Feb 7, 2024
1 parent a93fab4 commit 794ea00
Show file tree
Hide file tree
Showing 56 changed files with 1,091 additions and 1,179 deletions.
2 changes: 1 addition & 1 deletion woof-code/3builddistro
Original file line number Diff line number Diff line change
Expand Up @@ -506,7 +506,7 @@ chmod 755 sandbox3/pinstall.sh
#pemasu start 131207
echo "Removing extra documentation"
for i in $(ls sandbox3/rootfs-complete/usr/share/doc); do
case $i in legal|pmusic|pburn|pbackup|mtpaint|help|wvdial|ffconvert|cups|nls|puplogos|notecase|didiwiki|xarchive|frugalpup)
case $i in legal|pmusic|pburn|pbackup|mtpaint|help|wvdial|ffconvert|cups|nls|puplogos|notecase|didiwiki|xarchive|frugalpup|network_imgs)
continue
esac
if [ -d sandbox3/rootfs-complete/usr/share/doc/$i ] ; then
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
<!DOCTYPE html>
<html>
<head>
<title>HOWTO: Internet access using SNS</title>
<meta charset="utf-8">
<link href="/usr/share/doc/manual.css" rel="stylesheet" type="text/css">
<style>
li:not(:last-child) {
margin-bottom: 3px;
}
</style>
</head>
<body>
<a href="#" class="scroll_back_button" target="_self">&uArr;</a>

<div id="container">
<header class="logo-header">
<img class="header-logo" alt="Logo" src="/usr/share/doc/puppylogo96.png">
<h1>HOWTO: Internet access using SNS</h1>
</header>
<p class="byline">
<span>Author: <i>user1234</i></span>
<span class="page-date">Publishing date: 13.11.2022 15:11 UTC</span>
</p>
<section>
<h1>What is SNS?</h1>
<p>
<b>SNS</b> or <b>Simple Network Setup</b> is a utility designed by <b>BarryK</b>, which can be used to connect to a network easily in PuppyLinux.
</p>
</section>
<section id="opening-guide">
<h1>How to open up SNS?</h1>
<p>
Follow these steps to run <b>SNS</b>:-
<ol>
<li>Open up <b>Application Menu > Setup > Internet Connection Wizard</b>.</li>
<li>Click <b>Wired or wireless LAN</b>.<br><br>
<img src="network_imgs/network_wizard.jpg" alt="network_wizard.jpg">
</li>
<li>Click <b>Simple Network Setup</b> button.<br><br>
<img src="network_imgs/network_wizard_lan.jpg" alt="network_wizard_lan.jpg">
</li>
<li>This will open up <b>SNS</b>.</li>
</ul>
</p>
</section>
<section>
<h1>How to connect to Wireless Network?</h1>
<p>
Follow these steps to connect to a wirless network using SNS:-
<ol>
<li>Open up SNS (Read <a href="#opening-guide">how to open up SNS</a>).</li>
<li>Go to <b>Interfaces</b> tab in the SNS window (if not already opened in that tab).</li>
<li>You would see names of interfaces and their types. There will be some buttons present at the bottom of the window having the names of the interfaces that were listed above. Click on the button with the name of such an interface, which is listed as wireless one. Most probably, this will be <b>wlan<i>?</i></b>, where <b><i>?</i></b> is a number.<br><br>
If no <b>wlan<i>?</i></b> interface is listed then your wireless is probably not recognized and you should <a href="/usr/share/doc/forums.htm" target="_blank">request assistance on the Puppy Linux Forum</a>.<br><br>
<img src="network_imgs/sns_wlan0.jpg" alt="sns_wlan0.jpg">
</li>
<li>A new window will open. Select the network which you want to connect to.</li>
<li>Select the type of password encryption the network uses (most oftenly <b>WPA</b>).</li>
<li>Enter the password and click <b>Connect</b> button.<br><br>
<img src="network_imgs/sns_wlan0_connect.jpg" alt="sns_wlan0_connect.jpg">
</li>
<li>You will now be prompted that you have been connected to your network. Now enjoy surfing on the internet!</li>
</ol>
</p>
</section>
<section>
<h1>How to connect to Wired (Ethernet) Network?</h1>
<p>
Follow these steps to connect to a wired network using SNS:-
<ol>
<li>Open up SNS (Read <a href="#opening-guide">how to open up SNS</a>).</li>
<li>Go to <b>Interfaces</b> tab in the SNS window (if not already opened in that tab).</li>
<li>You would see names of interfaces and their types. There will be some buttons present at the bottom of the window having the names of the interfaces that were listed above. Click on the button with the name of such an interface, which is listed as wired one. Most probably, this will be <b>eth<i>?</i></b>, where <b><i>?</i></b> is a number.<br><br>
If no <b>eth<i>?</i></b> interface is listed then your ethernet is probably not recognized and you should <a href="/usr/share/doc/forums.htm" target="_blank">request assistance on the Puppy Linux Forum</a>.<br><br>
<img src="network_imgs/sns_eth0.jpg" alt="sns_eth0.jpg">
</li>
<li>You will now be prompted that you have been connected to your network. Now enjoy surfing on the internet!</li>
</ol>
</p>
</section>
</div>
</body>
</html>
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion woof-code/rootfs-petbuilds/connman-gtk/petbuild
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@ build() {
meson --buildtype=release --prefix=/usr -Duse_status_icon=false build
ninja -C build install
sed -e 's/^Categories=.*/Categories=Network;/' -e 's~^Icon=.*~Icon=network_connect~' -i /usr/share/applications/connman-gtk.desktop
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
<!DOCTYPE html>
<html>
<head>
<title>HOWTO: Internet access using ConnMan-GTK</title>
<meta charset="utf-8">
<link href="/usr/share/doc/manual.css" rel="stylesheet" type="text/css">
<style>
li:not(:last-child) {
margin-bottom: 3px;
}
</style>
</head>
<body>
<a href="#" class="scroll_back_button" target="_self">&uArr;</a>

<div id="container">
<header class="logo-header">
<img class="header-logo" alt="Logo" src="/usr/share/doc/puppylogo96.png">
<h1>HOWTO: Internet access using ConnMan-GTK</h1>
</header>
<p class="byline">
<span>Author: <i>user1234</i></span>
<span class="page-date">Publishing date: 25.11.2022 08:32 UTC</span>
</p>
<section>
<h1>What is ConnMan-GTK?</h1>
<p>
<b>ConnMan-GTK</b> is a GUI (Graphical User Interface) application which is used in all latest puppies to connect to the internet and bluetooth.
</p>
</section>
<section id="opening-guide">
<h1>How to open up ConnMan-GTK?</h1>
<p>
Open up <b>Application Menu > Puppy Setup > Internet</b>.

Otherwise, run this command in a terminal:-
<div class="code">connman-gtk</div>

The opened window should look somehting like this:-<br><br>
<img src="network_imgs/window.png" alt="network_imgs/window.png">
</p>
</section>
<section>
<h1>How to connect to Wireless Network?</h1>
<p>
Follow these steps to connect to a wirless network using SNS:-
<ol>
<li>Open up ConnMan-GTK (Read <a href="#opening-guide">how to open up ConnMan-GTK</a>).</li>
<li>Go to <b>Wireless</b> tab in the ConnMan-GTK window (if not already opened in that tab).</li>
<li>
The window should now look like this:-<br><br>
<img src="network_imgs/wlan.jpg" alt="network_imgs/wlan.jpg">
</li>
<li>The button present at the top-right of the window can be used to enable/disable WiFi.</li>
<li>Now click on any one of the listed wireless networks and then click on the <b>Connect</b> button.</li>
<li>
You will now be prompted to enter password for the wireless network you want to connect to. Enter the password and click <b>OK</b> button.<br><br>
<img src="network_imgs/wlan_connect.jpg" alt="network_imgs/wlan_connect.jpg">
</li>
<li>Wait for few seconds to get connected to the internet. Now enjoy surfing on the internet!</li>
</ol>
</p>
</section>
<section>
<h1>How to connect to Wired (Ethernet) Network?</h1>
<p>
Follow these steps to connect to a wirless network using SNS:-
<ol>
<li>Open up ConnMan-GTK (Read <a href="#opening-guide">how to open up ConnMan-GTK</a>).</li>
<li>Go to <b>Wired</b> tab in the ConnMan-GTK window (if not already opened in that tab).</li>
<li>
If you have just a single Ethernet connected, then you may be automatically connected to that network. If not, then click on any of the listed wired networks to select them; and then click <b>Connect</b> button:-<br><br>
<img src="network_imgs/eth.png" alt="network_imgs/eth.png">
</li>
<li>Wait for few seconds to get connected to the internet. Now enjoy surfing on the internet!</li>
</ol>
</p>
</section>
</div>
</body>
</html>
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions woof-code/rootfs-skeleton/usr/sbin/cups_shell
Original file line number Diff line number Diff line change
Expand Up @@ -85,11 +85,14 @@ if [ $HELP_ONLINE = false ] ;then
/etc/init.d/cups start
fi
#exec defaultbarehtmlviewer http://localhost:631/
$USEBROWSER "/usr/share/doc/cups_shell.htm" &
sleep 3
exec $USEBROWSER http://localhost:631/
fi
#show help sites
if [ $HELP_ONLINE = true ]; then
$USEBROWSER "http://www.murga-linux.com/puppy/viewtopic.php?p=444080#444080" &
$USEBROWSER "/usr/share/doc/cups_shell.htm" &
sleep 3
fi

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@
<link href="./manual.css" rel="stylesheet" type="text/css">
</head>
<body>
<a href="#" class="scroll_back_button" target="_self">&uArr;</a>

<div id="container">
<header class="logo-header">
<img class="header-logo" alt="Logo" src="puppylogo96.png">
Expand Down
32 changes: 22 additions & 10 deletions woof-code/rootfs-skeleton/usr/share/doc/HOWTO-microsoft.htm
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,11 @@
<title>Microsoft documents</title>
<meta charset="utf-8">
<link href="./manual.css" rel="stylesheet" type="text/css">
<base target="_blank">
</head>
<body>
<a href="#" class="scroll_back_button" target="_self">&uArr;</a>

<div id="container">
<header class="logo-header">
<img class="header-logo" alt="Logo" src="puppylogo96.png">
Expand All @@ -14,21 +17,30 @@ <h1>HOWTO: Microsoft documents</h1>
<p>
We know that <i>Microsoft Office</i> is the defacto standard, so it is something we have to cope with. The most common problem is Word documents -- many business people will type a document using Word and then attach it to an email and expect the recipients to be able to view it.
</p>
<p>
Here are links for all the programs which will help you create/view <i>Microsoft Office</i> files.
</p>
<p>
Note that 'portable' version of a program means that all the contents of the program will be located in a single directory, which many a times works better than regular installation.
</p>
<section>
<h2>Abiword and Gnumeric</h2>
<p>
These 2 applications let you open and edit very simple *.doc and *.xls files.
Abiword in particular should only be used for "simple" documents as it is known to have problems with more complex documents and a method of working using frequent saves should be employed. See: (<a href="https://oldforum.puppylinux.com/viewtopic.php?t=112434">oldforum.puppylinux.com/viewtopic.php?t=112434</a>)
</p>
</section>
<section>
<h2>LibreOffice</h2>
<h2>LibreOffice (Recommended)</h2>
<p>
LibreOffice is a free and open source office suite, a project of The Document Foundation.
The LibreOffice suite comprises programs for word processing, the creation and editing of spreadsheets, slideshows, diagrams and drawings, working with databases, and composing mathematical formulae.
</p>
<p>
Forum thread: <a href="https://oldforum.puppylinux.com/viewtopic.php?t=85915">oldforum.puppylinux.com/viewtopic.php?t=85915</a>
Forum thread: <a href="https://forum.puppylinux.com/viewtopic.php?t=404">forum.puppylinux.com/viewtopic.php?t=404</a>
</p>
<p>
Portable version of the program: <a href="https://forum.puppylinux.com/viewtopic.php?t=5635">forum.puppylinux.com/viewtopic.php?t=5635</a>
</p>
</section>
<section>
<h2>Abiword and Gnumeric</h2>
<p>
These 2 applications let you open and edit very simple *.doc and *.xls files.
Abiword in particular should only be used for "simple" documents as it is known to have problems with more complex documents and a method of working using frequent saves should be employed. See: (<a href="https://oldforum.puppylinux.com/viewtopic.php?t=112434">oldforum.puppylinux.com/viewtopic.php?t=112434</a>)
</p>
</section>
<section>
Expand All @@ -51,7 +63,7 @@ <h2>Softmaker FreeOffice</h2>
* FreeOffice Presentations, the presentation graphics software that handles PowerPoint files seamlessly and provides fantastic effects
</p>
<p>
i686 SFS... <a href="http://www.mediafire.com/file/vw947s6mnnl40c0/SoftMaker-FreeOffice2016-i686.sfs">http://www.mediafire.com/file/vw947s6mnnl40c0/SoftMaker-FreeOffice2016-i686.sfs</a>
Portable version of the program: <a href="https://forum.puppylinux.com/viewtopic.php?t=4232">forum.puppylinux.com/viewtopic.php?t=4232</a>
</p>
</section>
<section>
Expand Down

0 comments on commit 794ea00

Please sign in to comment.