# HG changeset patch # User Kai T. Ohlhus # Date 1476229706 -7200 # Node ID a7952259f5d311b46d9372b728aee6f5bede07b1 # Parent acfd3d7e2f92b6a00d2d5c4ed10b826c4538a7f6 Markdownify more pages, make better use of SVG and CSS. diff -r acfd3d7e2f92 -r a7952259f5d3 _includes/header.html --- a/_includes/header.html Wed Oct 12 01:47:36 2016 +0200 +++ b/_includes/header.html Wed Oct 12 01:48:26 2016 +0200 @@ -20,7 +20,7 @@
  • Docs
  • - {% octicon list-unordered height:18 class:"right left" %} + {% octicon list-unordered class:"octicon-topnav" %}
    • diff -r acfd3d7e2f92 -r a7952259f5d3 _posts/2015-09-23-oct-conf-darmstadt.markdown --- a/_posts/2015-09-23-oct-conf-darmstadt.markdown Wed Oct 12 01:47:36 2016 +0200 +++ b/_posts/2015-09-23-oct-conf-darmstadt.markdown Wed Oct 12 01:48:26 2016 +0200 @@ -6,6 +6,6 @@ --- The presentation slides are available at -[wiki.octave.org/OctConf_2015](http://wiki.octave.org/OctConf_2015). +[http://wiki.octave.org/OctConf_2015](http://wiki.octave.org/OctConf_2015). ![OctConf 2015]({{ "/img/octconf-2015.png" | absolute_url}}) diff -r acfd3d7e2f92 -r a7952259f5d3 about.md --- a/about.md Wed Oct 12 01:47:36 2016 +0200 +++ b/about.md Wed Oct 12 01:48:26 2016 +0200 @@ -24,22 +24,23 @@ GNU Octave is also freely redistributable software. You may redistribute it and/or modify it under the terms of -the GNU General Public License -(GPL) -as published by the -Free Software Foundation. +the [GNU General Public License (GPL)][1] as published by +the [Free Software Foundation][2]. -Octave was written by -John W. Eaton and -many others. -Because Octave is -free software -you are encouraged to help make Octave more useful by writing and -contributing additional functions for it, and by reporting any -problems you may have. +Octave was written by [John W. Eaton][3] and [many others][4]. +Because Octave is [free software][5] you are encouraged to help +make Octave more useful by writing and contributing additional +functions for it, and by reporting any problems you may have. + +[1]: https://www.gnu.org/copyleft/gpl.html +[2]: https://www.gnu.org/ +[3]: mailto:jwe@octave.org +[4]: http://hg.savannah.gnu.org/hgweb/octave/file/tip/doc/interpreter/contributors.in +[5]: https://www.gnu.org/philosophy/free-sw.html -## History + +# History Octave was originally conceived (in about 1988) to be companion software for an undergraduate-level textbook on chemical reactor @@ -62,11 +63,9 @@ Full-time development began in the Spring of 1992. The first alpha release was January 4, 1993, and version 1.0 was released February 17, 1994. Since then, Octave has been through several major revisions, is -included with Debian GNU/Linux and -SuSE -Linux distributions, and was reviewed in -the in the July, 1997 issue of the -Linux Journal. +included with [Debian GNU/Linux][6], [openSUSE][7], and many other +GNU/Linux distributions. Octave was reviewed in the in the July, 1997 +issue of the [Linux Journal][8]. Clearly, Octave is now much more than just another courseware package with limited utility beyond the classroom. Although our @@ -85,8 +84,11 @@ just as easily. Everyone is encouraged to share this software with others under the -terms of the GNU General Public License -(GPL). You are also +terms of the [GNU General Public License (GPL)][1]. You are also encouraged to help make Octave more useful by writing and contributing additional functions for it, and by reporting any problems you may have. + +[6]: https://www.debian.org/ +[7]: https://www.opensuse.org/ +[8]: http://www.linuxjournal.com/article/1225 diff -r acfd3d7e2f92 -r a7952259f5d3 bugs.md --- a/bugs.md Wed Oct 12 01:47:36 2016 +0200 +++ b/bugs.md Wed Oct 12 01:48:26 2016 +0200 @@ -4,93 +4,89 @@ menu: true --- - +GNU Octave uses the bug tracker at [Savannah][1]. +There you can [report a new bug][2], [browse recent bugs][1], +or [search for bugs][3]. + +[1]: https://savannah.gnu.org/bugs/?group=octave +[2]: https://savannah.gnu.org/bugs/?func=additem&group=octave +[3]: https://savannah.gnu.org/bugs/?func=search&group=octave -Your bug reports play an essential role in making Octave reliable. -You can make fixing problems easier by following the guidelines below. +

    +

    +{% octicon stop class:"octicon-stop-octave" %} +Please do not send bug reports to the +help-octave@gnu.org mailing list. +Most users of Octave do not want to receive bug reports. +
    +

    + +

    +

    +{% octicon stop class:"octicon-stop-octave" %} +Before reporting a new bug, read the guidelines below. +
    +

    -## Where and How to Send Bug Reports + +# Is the bug already known? -To report a bug in Octave, -submit -a bug report using the bug tracker. - -Please do not send bug reports to the -help-octave mailing list. Most users of Octave do not -want to receive bug reports. +When you encounter a problem, +the first thing to do is to see if it is already known. +Therefore, -When you encounter a problem, the first thing to do is to see if it -is already known. The best place to look for reported problems is -the Octave bug tracker. +- [search for already reported bugs at the bug tracker][3], -The Octave -reference manual also contains a list of known causes of -trouble. +- look at the list of known causes of trouble in the + [Octave reference manual][4]. -If you your problem does not appear to be known, then you should -report the problem. +If you your problem does not appear to be known, +then you should report the problem. Reporting a bug may help you by bringing a solution to your problem, or it may not. In any case, the principal function of a bug report is to help the entire community by making the next version of Octave work better, so you can contribute to the maintenance of Octave. +[4]: {{site.docs_url}}/Trouble.html#Trouble -## Have You Found a Bug? + + +# Is it really a bug? If you are not sure whether you have found a bug, here are some guidelines: - +- If you are an experienced user of programs like Octave, your + suggestions for improvement are welcome in any case. -## Making Your Bug Report Count + +# Make your bug report count In order for a bug report to serve its purpose, you must include the information that makes it possible to fix the bug. The fundamental principle of reporting bugs usefully is this: -report all the facts. If you are not sure whether to +**report all the facts**. If you are not sure whether to state a fact or leave it out, state it. Often people omit facts because they think they know what causes the @@ -120,50 +116,39 @@ also need to include the following to enable someone to investigate the bug: - +- If you wish to suggest changes to the Octave source, send them as context + diffs. If you discuss something in the Octave source, refer to it by + context, not by line number, because the line numbers in the development + sources probably won't match those in your sources. -## Sending Patches for Octave + +# Sending Patches for Octave -If you have a suggested fix for a bug, please attach it to your -report in the tracker. Your patch is more likely to be reviewed -if you follow the guidelines in the Octave manual about to -generate a changeset +If you have a suggested fix for a bug, please attach it to your report in +the tracker. Your patch is more likely to be reviewed if you follow the +guidelines in the Octave manual about to [generate a changeset][5] and submit patches for Octave. + +[5]: {{site.docs_url}}/Basics-of-Generating-a-Changeset.html#Basics-of-Generating-a-Changeset diff -r acfd3d7e2f92 -r a7952259f5d3 css/octave.css --- a/css/octave.css Wed Oct 12 01:47:36 2016 +0200 +++ b/css/octave.css Wed Oct 12 01:48:26 2016 +0200 @@ -1,3 +1,32 @@ +svg.octicon-rss-octave { + fill: #ffffff; + background-color: #fb9e3a; + width: 16px; + height: 16px; + padding: 2px; +} + +svg.octicon-stop-octave { + fill: #ff0000; + width: 18pt; + height: 18pt; + float: left; + margin-right: 10px; +} + +svg.octicon-topnav { + height: 18px; +} + +span.post-small { + font-size: 85%; +} + +div.alert { + border: 2px solid #ff0000; + padding: 5px; +} + div#logo { color: #0790c0; margin: 10px; diff -r acfd3d7e2f92 -r a7952259f5d3 index.md --- a/index.md Wed Oct 12 01:47:36 2016 +0200 +++ b/index.md Wed Oct 12 01:48:26 2016 +0200 @@ -5,37 +5,40 @@ **[GNU Octave][1]** is a high-level interpreted language, primarily intended for numerical computations, with built-in plotting and visualization capabilities. +Many [Octave Forge packages][2] provide useful extensions for +several scientific and engineering applications. +The GNU Octave language is quite similar to [Matlab][3] +so that most programs are easily portable. + +Octave is distributed under the terms of the +[GNU General Public License][4]. [![GNU Octave 4.0.3 - Licensed under CC BY-SA 3.0][screen-small]][screen] [1]: http://www.octave.org +[2]: http://octave.sourceforge.net/packages.php +[3]: https://www.mathworks.com/matlab +[4]: https://www.gnu.org/copyleft/gpl.html [screen]: {{ "/img/screenshot-2016.png" | relative_url }} [screen-small]: {{ "/img/screenshot-2016-small.png" | relative_url }} -The GNU Octave language is quite similar to [Matlab][2] -so that most programs are easily portable. - -[2]: https://www.mathworks.com/matlab - -Octave is distributed under the terms of the -[GNU General Public License][3]. - -[3]: https://www.gnu.org/copyleft/gpl.html +--- -## News ([RSS]({{ "/feed.xml" | relative_url }})) +# [{% octicon rss class:"octicon-rss-octave" %}]({{ "/feed.xml" | relative_url }}) News {% for post in site.posts limit:3 %} - [{{ post.title }}]({{ post.url | relative_url }}) - ({{ post.date | date: "%b %-d, %Y" }}) - - {{ post.excerpt }} + ({{ post.date | date: "%b %-d, %Y" }}): + {{ post.excerpt | strip_html}} {% endfor %} -## Some Octave Examples +--- + +## Some Examples - Solve systems of equations with linear algebra operations on **vectors** and **matrices**: @@ -57,24 +60,3 @@ {% endhighlight %} ![Sine plot]({{ "/img/plot.png" | relative_url }}) - - - -### Octave Forge - -[Octave Forge](http://octave.sourceforge.net/) -is a central location for development of packages for GNU Octave, -similar to Matlab's toolboxes. -To install a package, use the pkg command from the Octave prompt by typing: - -
    -
    -{% highlight text %} -pkg install -forge package_name -pkg load package_name -{% endhighlight %} -
    -
    - Browse Packages -
    -