Skip to content

Latest commit

 

History

History
59 lines (37 loc) · 2.88 KB

README.md

File metadata and controls

59 lines (37 loc) · 2.88 KB

This repository is an out of the box development environment for Gephi plugins. It contains the latest stable version of Gephi modules so you can run a development version of Gephi in seconds. Checkout the Bootcamp for examples of the different type of plugins you can create.

Branches contains Gephi Plugins supported by the core team:

Get started

Follow the steps to get the right development environment for developing Gephi plug-ins.

  • Download and install the latest version of Netbeans IDE.

  • Fork and checkout the latest version of this repository:

      git clone [email protected]:username/gephi-plugins.git
    
  • Start Netbeans and Open Project. This folder is automatically recognized as a module suite.

  • Right click on the project and select 'Run'. This starts Gephi.

You can also run Gephi from the command-line using the 'ant run' command.

Create a plugin

Create a new module

  • In Netbeans, expand the '''Gephi Plugins''' project and right-click on Modules. Select '''Add New...'''
  • Enter the plugin name: '''MyFirstPlugin''' and click '''Next'''.
  • In the next panel, enter a unique codebase name, for instance '''org.myname.myfirstplugin''' and click '''Finish'''.
  • In the Netbeans Project tree, you should see now your module '''MyFirstPlugin'''. Expand it to find its Source Package. Here you will place your code.

Brand your plugin

  • Right-click on your plugin project '''MyFirstPlugin''' and select '''Properties'''.
  • Select '''Display''' on the left panel and fill '''Display Category''', '''Short Description''' and '''Long Description'''.
  • Select '''Packaging''' on the left panel and fill '''License''', '''Homepage''' (if exists) and '''Author''' information.
  • Click on OK to validate changes.

Distribute your plugin

When you successfully tested your plugin, it's time to create a release. Verify that you have latest updates of Gephi JARs:

  • Pull latest changes:

      git checkout master
      git pull
      git checkout mybranch
    
  • Test your plugin again in case of an update. If it's okay:

  • Right-click on the project and select '''Package As''' and then '''NMBs'''.

  • Go to the '''build''' folder and find the created '''plugin-release.zip''' file. Individual NBM files (one per each module) are packaged in this zip.

Now you can publish you plugin on the Gephi Plugin portal.

Plugins Portal

Our wiki contains a good list of tutorials to code plugins. Also checkout the Bootcamp for real examples.