diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..231d027 --- /dev/null +++ b/.gitignore @@ -0,0 +1,29 @@ +# Jekyll +_site/ +.jekyll-cache +.jekyll-metadata +.sass-cache + +# Ruby +.bundle/ +.byebug_history +.ruby-gemset +.ruby-version +*.gem +Gemfile.lock + +# Files +.analysis +.DS_Store +*.swp +*~ + +# Folders +/vendor +bbin/ +bin/ +coverage +gh-pages/ +pkg/ +test/dest +tmp/* diff --git a/Gemfile b/Gemfile new file mode 100644 index 0000000..37f5eaa --- /dev/null +++ b/Gemfile @@ -0,0 +1,2 @@ +source 'https://rubygems.org' +gem 'github-pages', group: :jekyll_plugins diff --git a/README.md b/README.md index 87619e6..1a927aa 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,14 @@ -# jython.github.io -Web site for Jython +# Jython Website +This is the source repository for the Jython website. + +## To develop the website + +A quick guide to developing the website locally + +1. Clone this repository +2. Run `bundle exec jekyll serve` in the repository. See [here](https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll) for more information on setting up Jekyll +3. Browse to [http://127.0.0.1:4000](http://127.0.0.1:4000) +4. View the website locally +5. Make changes to the source +6. Refresh the browser page and the changes should be visible +7. Once your happy with the changes create a pull request diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000..a79c9eb --- /dev/null +++ b/_config.yml @@ -0,0 +1,4 @@ +title: Jython +description: The Python runtime on the JVM + +theme: jekyll-theme-slate diff --git a/_data/navbar.yml b/_data/navbar.yml new file mode 100644 index 0000000..ab26446 --- /dev/null +++ b/_data/navbar.yml @@ -0,0 +1,37 @@ +# This file contains the contents of the navigation bar. +# If subItems are defined the menu will contain a drop down containing the sub items +navbar: + - title: Home + url: index + - title: News + url: news + - title: Download + url: download + - title: Documentation + subItems: + - title: Installation + url: installation + - title: JavaDoc + url: http://www.javadoc.io/doc/org.python/jython-standalone/2.7.1 + - title: Jython Book + url: https://jython.readthedocs.io/en/latest/ + - title: Wiki + url: https://wiki.python.org/jython/ + - title: Archived Sites + url: archived_sites + - title: Development + subItems: + - title: Bug tracker + url: http://bugs.jython.org/ + - title: Github + url: https://github.com/jythontools/jython + - title: Mercurial + url: https://hg.python.org/jython/ + - title: Mailing List + url: https://sourceforge.net/p/jython/mailman/ + - title: Developer Guide + url: https://jython-devguide.readthedocs.io/en/latest/ + - title: Website source + url: https://github.com/jython/jython.github.io/ + - title: Links + url: links diff --git a/_includes/navigation.html b/_includes/navigation.html new file mode 100644 index 0000000..b9952cf --- /dev/null +++ b/_includes/navigation.html @@ -0,0 +1,89 @@ +
+ {% for item in site.data.navbar.navbar %} + {% if item.subItems == null %} + {{ item.title }} + {% else %} +
+ +
+ {% for entry in item.subItems %} + {{ entry.title }} + {% endfor %} +
+
+ {% endif %} + {% endfor %} +
+ + \ No newline at end of file diff --git a/_layouts/default.html b/_layouts/default.html new file mode 100644 index 0000000..830a986 --- /dev/null +++ b/_layouts/default.html @@ -0,0 +1,59 @@ + + + + + + + + + + +{% seo %} + + + + + +
+
+ View on Github + + + + {% if site.show_downloads %} +
+ Download this project as a .zip file + Download this project as a tar.gz file +
+ {% endif %} + {% include navigation.html %} +
+
+ + +
+
+ {{ content }} +
+
+ + + + + {% if site.google_analytics %} + + {% endif %} + + diff --git a/archived_sites.md b/archived_sites.md new file mode 100644 index 0000000..270e421 --- /dev/null +++ b/archived_sites.md @@ -0,0 +1,14 @@ +--- +title: Archived Sites +--- +## Old Archived Jython Websites +This is the place to access old versions of the Jython website. + +### [Jython 2.5 - 2.7](http://www.jython.org/) + +### [Jython 2.2.1](http://www.jython.org/archive/221/index.html) + +### [Jython 2.2](http://www.jython.org/archive/22/index.html) + +### [Jython 2.1](http://www.jython.org/archive/21/index.html) + diff --git a/assets/css/style.scss b/assets/css/style.scss new file mode 100644 index 0000000..dd1114b --- /dev/null +++ b/assets/css/style.scss @@ -0,0 +1,16 @@ +--- +--- + +@import "{{ site.theme }}"; + +#header_wrap .inner { + padding: 0px 10px 0px 10px; +} + +#logo { + box-shadow: none; + border: none; + webkit-box-shadow: none; + padding: 2px; + margin: 10px 0px 0px 0px; +} diff --git a/assets/favicon32.png b/assets/favicon32.png new file mode 100644 index 0000000..9835a02 Binary files /dev/null and b/assets/favicon32.png differ diff --git a/assets/jython.png b/assets/jython.png new file mode 100644 index 0000000..593c1a8 Binary files /dev/null and b/assets/jython.png differ diff --git a/download.md b/download.md new file mode 100644 index 0000000..5359d06 --- /dev/null +++ b/download.md @@ -0,0 +1,17 @@ +--- +title: Downloads +--- +## Current Version +The current version of Jython is 2.7.1 +It can be downloaded here: +- [Jython Installer](http://search.maven.org/remotecontent?filepath=org/python/jython-installer/2.7.1/jython-installer-2.7.1.jar) - Use this to install Jython. +- [Jython Standalone](http://search.maven.org/remotecontent?filepath=org/python/jython-standalone/2.7.1/jython-standalone-2.7.1.jar) - Use this to run Jython without installing or to embed Jython in a Java application. + +For information on installing see [Installation](installation). + +This version is supported on Java 7 and 8. + +## Previous Versions +Previous versions of Jython are available from: +- [Jython Installer](https://search.maven.org/search?q=g:org.python%20AND%20a:jython-installer&core=gav) +- [Jython Standalone](https://mvnrepository.com/artifact/org.python/jython-standalone) diff --git a/index.md b/index.md new file mode 100644 index 0000000..89ded3a --- /dev/null +++ b/index.md @@ -0,0 +1,32 @@ +--- +title: Home +--- +## What is Jython? +Jython is a [Java](https://go.java/index.html) implementation of [Python](https://www.python.org/) that combines expressive power with clarity. Jython is freely available for both commercial and non-commercial use and is distributed with source code under the [PSF License v2](https://github.com/jythontools/jython/blob/master/LICENSE.txt). Jython is complementary to Java and is especially suited for the following tasks: + + * Embedded scripting - Java programmers can add the Jython libraries to their system to allow end users to write simple or complicated scripts that add functionality to the application. + * Interactive experimentation - Jython provides an interactive interpreter that can be used to interact with Java packages or with running Java applications. This allows programmers to experiment and debug any Java system using Jython. + * Rapid application development - Python programs are typically 2-10x shorter than the equivalent Java program. This translates directly to increased programmer productivity. The seamless interaction between Python and Java allows developers to freely mix the two languages both during development and in shipping products. + +Here is an example of running Python code inside a simple Java application. +```java +import org.python.util.PythonInterpreter; + +public class JythonHelloWorld { + public static void main(String[] args) { + try(PythonInterpreter pyInterp = new PythonInterpreter()) { + pyInterp.exec("print 'Hello Python World!'"); + } + } +} +``` + Ready to get started? Head over to [Downloads](download) + +## Who uses Jython? +Jython is embedded in lots of projects. See some from [MVNRepository](https://mvnrepository.com/artifact/org.python/jython-standalone/usages) + +- [IBM Websphere](https://www.ibm.com/developerworks/websphere/library/techarticles/1004_gibson/1004_gibson.html) - Use Jython to provide administrative scripting capabilities. +- [Apache PIG](https://pig.apache.org/) - Use Jython to support user defined functions. +- [ImageJ](http://imagej.net) - Use Jython to provide scripted image processing. +- [GDA](http://www.opengda.org/) - Use Jython to script scientific experiments. +- [Robot Framework](http://robotframework.org/) - A generic test automation framework for acceptance testing and acceptance test-driven development (ATDD) which runs on Jython. \ No newline at end of file diff --git a/installation.md b/installation.md new file mode 100644 index 0000000..4cfbe4e --- /dev/null +++ b/installation.md @@ -0,0 +1,48 @@ +--- +title: Installation +--- +## Installer Jar +Jython 2.7.1 is distributed via an executable jar file installer. After +[downloading](download) it, either double click the `jython-installer-2.7.1.jar` or run java with the -jar option +``` +$ java -jar jython-installer-2.7.1.jar +``` + +This will start the regular GUI installer on most systems, or a console installer on headless systems. To force the installer to work in headless mode invoke the installer as: +``` +$ java -jar jython-installer-2.7.1.jar --console +``` +The installer will then walk through a similar set of steps in +graphical or console mode: showing the license, selecting an install +directory and JVM and actually copying Jython to the file system. +After this completes, Jython is installed in the directory you +selected. Executing a script in the install directory, `jython` on Unix-like systems or `jython.exe` on Windows, will start up the Jython +console, which can be used to dynamically explore Jython and the Java +runtime, or to run Jython scripts. + +## Standalone Jar + +The standalone option does no caching and so avoids the startup overhead (most likely at the cost of some speed in calling Java classes, but I have not profiled it) + +You can try it out by running the installer: +``` +$ java -jar jython-installer-2.7.1.jar +``` +then when you come to the "Installation type" page, select "Standalone". + +The installation will generate a `jython.jar` with the Python standard library (`/Lib`) files included, which can be run as: +``` +$ java -jar jython.jar +``` +Of course you can run scripts just by calling them as you might expect: +``` +$ java -jar jython.jar script.py +``` +Or, add this file to the classpath of your application. + +## Installation options + +You can get a list of installer options (to install Jython unattended, for example) by running: +``` +$ java -jar jython-installer-2.7.1.jar --help +``` diff --git a/links.md b/links.md new file mode 100644 index 0000000..9d98390 --- /dev/null +++ b/links.md @@ -0,0 +1,10 @@ +--- +title: Links +--- +## Jython related projects + +### [JyNI](https://jyni.org/) +Aims to CPython extension support to Jython. To allow extensions such as [NumPy](http://www.numpy.org/) or [SciPy](https://www.scipy.org/) to be used in Jython. + +### [The Very Slow Jython Project](https://github.com/jeff5/very-slow-jython) +The aim of the Very Slow Jython project is to re-think implementation choices in the Jython core, through the gradual, narrated evolution of a toy implementation, starting from zero code. diff --git a/news.md b/news.md new file mode 100644 index 0000000..2cf43f3 --- /dev/null +++ b/news.md @@ -0,0 +1,37 @@ +--- +title: News +--- +## News + +### New website (October 2018) +Welcome to the new Jython website. The main improvements are: +- Redesign to fit the modern web, e.g. mobile responsive +- Move hosting to [GitHub pages](https://pages.github.com/). To allow easier maintenance and encourage community contribution +- Delivered over HTTPS. + +### Jython 2.7.1 Final Released (July 2017) + +We thought 2017-07-01 was a perfect time to release version 2.7.1 This is a bugfix release. Bug fixes include improvements in SSL and pip support along with lots of improvements in CPython compatibility. + +Please see the [NEWS](https://github.com/jythontools/jython/blob/master/NEWS) file for detailed release notes. This release of Jython requires JDK 7 or above. + +This release is being hosted at maven central. There are three main distributions. In order of popularity: + +- Most likely, you want the [traditional installer](http://search.maven.org/remotecontent?filepath=org/python/jython-installer/2.7.1/jython-installer-2.7.1.jar). NOTE: the installer automatically installs pip and setuptools (unless you uncheck that option), but you must unset `JYTHON_HOME` if you have it set. +- A [pre-built standalone version](http://search.maven.org/remotecontent?filepath=org/python/jython-standalone/2.7.1/jython-standalone-2.7.1.jar). + +### Jython 2.7.0 Final Released (May 2015) + +Please see the [NEWS](https://github.com/jythontools/jython/blob/master/NEWS) file for detailed release notes. + +Read more on [Frank Wierzbickis Weblog](http://fwierzbicki.blogspot.fi/2015/05/jython-270-final-released.html) + +### Jython 2.7 Release Candidate 3 Released (April 2015) + +Please see the [NEWS](https://github.com/jythontools/jython/blob/master/NEWS) file for detailed release notes. + +Read more on [Frank Wierzbickis Weblog](http://fwierzbicki.blogspot.fi/2015/04/jython-27-release-candidate-3-available.html) + +### Jython 2.7 PyCon 2015 Talk** (April 2015) + +Jim Baker gave a talk at PyCon 2015 in Montreal about how we got to Jython 2.7 and what's coming next. [Watch the video here](https://www.youtube.com/watch?v=hLm3garVQFo>)