OSDN Git Service

InstallBuilderのバージョン記述を更新(Mac)
[neighbornote/NeighborNote.git] / install.txt
index b21360c..b7b7efe 100644 (file)
-Hello.
-  
-Welcome to NeverNote.     
+Welcome to Neighbornote.     
+
+This is a very basic clone of Evernote designed to run on Linux.
+It is written in Java so it will also run on other platforms as well but the primary focus has been to try 
+and get a usable environment for Linux (although I use it on Windows with no problems).
+
+See release.txt for details of what works and what doesn't work.
+
+--- Requirement ---
+
+Before trying, please be sure you have Java 1.6 installed.  Depending upon your distribution this may be installed via a package manager or just installing NeverNote may cause Java to be downloaded & installed. This product is tested on Oracle/Sun Java
+
+=================================
+=================================
+==  LINUX INSTALL INSTRUCTIONS ==
+=================================
+=================================
+
+* NOTE:
+Only i386 & amd64 are currently supported.  This is due to the fact that Qt Jambi only has prebuilt i386 & amd64 versions.  If you wish to use this on another platform, then you'll need to build Jambi for yourself.  If you do, please post a message on the user forums & I'll distribute it with later builds.  I don't have access to other platforms or I'd probably do it myself.
+
+
+*********************************************************
+*** Debian or Debian based systems (including Ubuntu) ***
+*********************************************************
+1.) Download the appropriate version (i386 or amd64).
+2.) Issue dpkg -i <package> 
+
+
+************************
+*** RPM ased systems ***
+************************
+--NOTE: I used Alien to create these, so I'm not too sure how usable they are.
+1.) Download the appropriate version (i386 or amd64).
+2.) Issue rpm -ivf <package> 
+
+
+
+************************
+*** Manual install   ***
+************************
+1.) Download the appropriate binary file (i386 or amd64).
+2.) As root, run the installation program.  It should walk you through the rest.
+
+
+
+************************
+*** Manual install   ***
+************************
+1.) Download the appropriate version (i386 or amd64).
+2.) Unzip the files to a local directory.
+3.) As root, issue ./install.sh
+
+
+
+===========================
+===========================
+==  WINDOWS INSTRUCTIONS ==
+===========================
+===========================
+1.) Download the Windows installer.  It doesn't matter if you are running 64 or 32 bit since the install program has the needed packages for both.
+2.) Run the install.  You shouldn't need administrator access.
 
-This is a very basic clone of Evernote designed to run on Linux.  It is written in Java so it will also run on other platforms as well but the primary focus has been to try and get a usable environment for Linux.  While this is designed to work with Evernote, it is in no way connected with or supported by Evernote.  Any problems you encounter will not be corrected by them and, since this is GPL software, you are using this software at your own risk.  See release.txt for details of what works and what doesn't work.
 
-Before trying to run this, please be sure you have Java 1.6 and QT Jambi 4.5 installed.  Java will probably be installed via a package manager and you'll probably need to download QT Jambi from  http://qt.nokia.com/downloads.  The only thing you need to do with Jambi is to have the files untarred to a directory. You'll need to edit the install scripts to point to this directory (the instructions are below).  People have used this with both 64 & 32 bit versions of Linux as well as OpenJDK & Sun's Java and (so far) have not encountered any problems with these different environments.
 
 
---- To Install --- 
-1.) Edit nevernote.sh (for Linux) or nevernote.bat (for Windows) in this directory.  At the top of the file there will be 4 variables.
-2.) Edit the NEVERNOTE variable to point to the full path of where you installed NeverNote.
-3.) Edit the JAMBI_LOCATION variable to point to the full path of where QT Jambi was installed.
-4.) Edit the JABBI_VERSION variable to indicate the proper QT Jambi version you have installed.  I've tested with 4.5 only.  I don't think older versions will work.
-5.) Edit the JAMBI_PLATFORM variable to indicate the Linux/Windows platform you are running.  
+=============================
+=============================
+== MAC OS-X   INSTRUCTIONS ==
+=============================
+=============================
+-- NOTE: I don't have OS-X so I can't verify the stability or usability of this under OS-X
+1.) Download the Mac install version.
+2.) Run the install program.
+3.) Run neighbornote.sh from the installation directory.
 
-There are additional options if you wish to run multiple copies under the same userid.  These settings are optional and, depending upon your needs, you probably don't need to touch them.  Please see either nevernote.sh or nevernote.bat for details.  
 
-Some archive managers do not untar all subdirectories properly because some of the subdirectories are initially empty.  After untarring, you should see a lib, res, images, db, qss, and logs directories directly under the nevernote directory.  Some of these will be empty until you begin running the program.
 
-If you've read this far and have done everything described above then you're done.  You should be able to run the nevernote.sh (or nevernote.bat for Windows) script and start things up.  The initial synchronize will take a while depending upon the amount of data.  
 
-This prgram has the ability to synchronize against production servers as well as sandbox servers or to use multiple accounts under the same Linux/Windows ID.  Please see the startup script for details if you wish to run multiple copies under the same Linux or Windows userid.     DO NOT MIX PRODUCTION & SANDBOX DATA IN THE SAME DATABASE OR HAVE MULTIPLE USER ACCOUNTS IN THE SAME DATABASE!  Using the same database to store both production & sandbox data or multiple Evernote accounts will cause problems.      If you wish to run multiple copies of NeverNote you must have separate installation directories for each and you MUST edit the startup scripts and give any one after the first a separate name.  By default, it will try to use the sandbox servers.  If you wish to use production data you can change this under the Edit/Preferences directory option.  You must change this BEFORE your first synchronization with Evernote. 
+=====================
+==  Configuration  ==
+=====================
+There are additional options if you wish to run multiple copies under the same userid and options which impact how Java works.  These settings are optional and, depending upon your needs, you probably don't need to touch them. 
 
+To run under multiple IDs, you need to pass a parameter NN_NAME="<name>" to the neighbornote.sh shell script where <name> is whatever name you want to identify this instance as.  For example, ./nixnote.sh NN_NAME="test" will create a separate database called "test".  Anything you put in there will be separate from the default NeverNote database, so the username can also be different.
+
+
+
+
+==========================
+== To Build From Source ==
+==========================
+To build from source package, you need several additional  utilities and developers kit.
+
+  JDK:
+       Java standard developers distribution.  you can download it from http://www.java.com/
+       or as Linux  package
+
+  lupdate, lrelease (not needed if you use Eclipse & don't want to wory about non-English translations): 
+       translation helper  ulitilites
+       These tools is bundled with qtjambi distribution where bin/ directory of qtjambi 
+
+
+
+***************************
+** To Build With Eclipse **
+***************************
+
+There are sample project files and classpath definitions
+in the source tree, but basically you need to import the source, add all the jar files to your path, & build.  The Jambi jar files you need to run it under eclipse will depend upon the platform (32 or 64 bit) you are using.  
+
+
+**************************
+* Build by command line  * 
+**************************
+
+To build without Eclipse IDE, you need to prepare 'ant' utility.
+ - Compile and build  jar file
+
+   $ ant jar
+
+ - Update translation files
+
+   $  ant update-tr
+
+ - Clean binaries and temporary files
+
+   $ ant clean
+       or
+   $ ant all-clean
+ - edit translations
+  
+    please see translations/README