Coder Social home page Coder Social logo

jamescheney / database-wiki Goto Github PK

View Code? Open in Web Editor NEW
2.0 7.0 0.0 144.72 MB

Automatically exported from code.google.com/p/database-wiki

License: GNU General Public License v3.0

Shell 0.22% CSS 5.58% HTML 0.40% JavaScript 0.39% Java 93.28% Batchfile 0.13%

database-wiki's Introduction

*DEPRECATED VERSION*

Database Wiki
=============

A wiki lets users collaborate on Web content easily through a Web
browser, and wikis also make it easier to understand the process by
which some data was created by recording detailed history records. A
Database Wiki is a wiki for structured data, providing both
database-like capabilities to structure and query data and wiki-like
capabilities for collaboration and transparency.

Entry points
============

The entry points are defined as main methods of classes in
org.dbwiki.main:

  CreateServer
  DatabaseImport
  DatabasePackageExport
  DatabasePackageImport
  DropDatabaseWiki
  DropServer
  ImportPresentationFiles
  StartServer
  
For convenience, various wrapper scripts are included in the root
directory for invoking the various entry points with appropriate
classpaths using configuration files in
./resources/configuration/. Those ending with a .sh suffix are
suitable for UNIX platforms (including Linux and Mac OS X).  Those
ending with a .cmd suffix are suitable for Windows.

Initialising a server
---------------------

Java class:

  CreateServer <config-file> <user-listing>

Scripts:

  create-server.sh
  create-server.cmd

This creates the following tables in the relational database:

  _database
  _presentation
  _user
  
The first argument is a server configuration file. The second argument
is a user configuration file.

Example files are currently in:

  ./resources/configuration/server/config.sample
  ./resources/configuration/server/users.sample

We recommend copying these into 

  ./resources/configuration/server/config
  ./resources/configuration/server/users

and editing according to your local configuration, then the script can
be used.

Starting a server
-----------------

Java class:

  StartServer <config-file>

Scripts:

  start-server.sh
  start-server.cmd
  
You should now be able to access your Database Wiki server through
your web browser by going to:

  http://localhost:8080/

Importing XML data into a new database wiki
-------------------------------------------

Java class:

  DatabaseImport <config-file> <name> <title> <path> <xml-file> <user>

Scripts:

  database-import.sh  <name> <title> <path> <xml-file> <user>
  database-import.cmd <name> <title> <path> <xml-file> <user>

The <name> is a short name for the database.

The <title> is a descriptive name for the database.

The <path> is the path from the root to the data entries
(e.g. if the XML file is of the form
  <things><item>...</item>...<item>...</item></things>
then a suitable path would be '/things').

The <user> is the name of the user to use to record the import.

Importing presentation data
---------------------------

Java class:

  ImportPresentationFiles <config-file> <db-name> <path> <user>

Script:

  import-presentation-files.sh  <db-name> <path> <user>
  import-presentation-files.cmd <db-name> <path> <user>

The <path> is the file path to the presentation files. The files should be named:

  <path> + <db-name> + ".css"
  <path> + <db-name> + ".layout"
  <path> + <db-name> + ".template"

Dropping a database wiki
------------------------

Java class:

 DropDatabaseWiki <config-file>

Scripts:

  drop-database.sh
  drop-database.cmd
  
You will be asked which database wiki you wish to drop. All data
associated with that database wiki will be deleted.

Dropping a server
-----------------

Java class:

  DropWikiServer <config-file>
  
Scripts:

  drop-wiki-server.sh
  drop-wiki-server.cmd

You will be asked whether you also wish to drop all the database wikis.
All of the tables created by CreateServer will be deleted. If you
answer yes to the question, then the all the database wiki data will
also be deleted.



TODO: describe DatabasePackageExport and DatabasePackageImport

database-wiki's People

Contributors

jamescheney avatar

Stargazers

Daniel Hines avatar  avatar

Watchers

Stefan Fehrenbach avatar James Cloos avatar Catalina Predoi avatar  avatar Liljana Dimovska avatar  avatar Benjamin avatar

database-wiki's Issues

Update parsing code to use modern version of Parboiled/Pegdown

We should update the code to use the most recent version of the Parboiled library, but this is complicated somewhat by the fact that we are using a modified version of part of it (the Pegdown markdown parser). Longer-term, it would be good to upgrade to the latest library version and refactor the code to specialize Pegdown rather than modifying it directly.

Add support for pre/post indexing

Step 1.  Merge trunk changes into a copy of Hui's project branch.  See if this 
works.

Step 2.  Implement simple way of re-indexing when an entry changes.

Step 3 (future?) Implement smarter re-indexing.

Original issue reported on code.google.com by [email protected] on 25 Nov 2011 at 4:32

Login bugs

Logging in doesn't work properly:

1.  If you log in with an invalid user id, there is no failure message, instead 
from then on the login link is a no-op/page forward.

2.  If you log in with a valid user id but incorrect password, it succeeds.  
(should fail/give an error message).

3.  There is no way to log out short of restarting the browser.

Original issue reported on code.google.com by [email protected] on 16 Mar 2012 at 9:59

javascript imports in templates


The template mechanism should provide a symbol @imports so that we can add new 
javascript library imports in one place (in the code) instead of once per 
template.

Otherwise we will have to change all the templates manually whenever the 
javascript code we're importing changes.

The default and built-in templates should be changed to take this into account 
too.

Original issue reported on code.google.com by [email protected] on 23 Nov 2011 at 11:05

Hi........

What steps will reproduce the problem?
1.
2.
3.

What is the expected output? What do you see instead?


What version of the product are you using? On what operating system?


Please provide any additional information below.

Original issue reported on code.google.com by [email protected] on 23 Nov 2013 at 8:54

Binary distribution and installation

Develop a binary (JAR) distribution and installation script that puts the 
program somewhere global and runs the server from there rather than running 
from the source directory.

Original issue reported on code.google.com by [email protected] on 5 Jun 2011 at 6:10

There are no generated keys

Attempting to insert schema elements in the App Engine version leads to failure 
with the error: "There are no generated keys."

Seems to be due to getGeneratedKeys not returning anything, so maybe something 
isn't defined as auto_increment in Cloud SQL that should be.


Original issue reported on code.google.com by [email protected] on 28 Jan 2015 at 12:12

Data import exceeds 60 second limit

Loading a large dataset through the web interface on the App Engine version 
leads to an error (the connection is dropped before the data is finished 
loading).

App Engine limits the time per request to 60 seconds.  

To do: investigate use of backends or tasks to handle imports that take longer 
than 60 seconds.

Original issue reported on code.google.com by [email protected] on 8 Jan 2015 at 10:57

Make wiki pages global

Currently, wiki pages are associated with collections and can only query data 
in that collection.  

This enhancement would make the "wiki page" component of the system a 
server-level object rather than having several Wiki objects, one per 
collection.  It would also allow writing queries that access data from more 
than one collection (which might in turn require some modifications to the 
schema language to provide top-level variable bindings for the different 
collections).

This would also mean that we could write documentation for the whole system as 
(global) wiki pages, making it more self-documenting.

Original issue reported on code.google.com by [email protected] on 12 Feb 2015 at 4:09

Schema-versioning data import is broken.

Data import is currently broken using the schema archiving  For example, using 
attached trivial file foo.xml, I get:


$ sh database-import.sh FOO FOO foo.xml jcheney
[TIME] [Duplicate version name]: Version 8 May 2011 17:06:49 already exists
    at org.dbwiki.data.time.version.VectorVersionIndex.add(VectorVersionIndex.java:70)
    at org.dbwiki.driver.rdbms.DatabaseImportHandler.endImport(DatabaseImportHandler.java:64)
    at org.dbwiki.data.io.XMLDocumentImportReader.start(XMLDocumentImportReader.java:106)
    at org.dbwiki.web.server.WikiServer.registerDatabase(WikiServer.java:717)
    at org.dbwiki.main.DatabaseImport.main(DatabaseImport.java:91)

This also happens if I try to add data through the web interface.

Original issue reported on code.google.com by [email protected] on 8 May 2011 at 4:09

Attachments:

Creating database from existing XML is confusing

To reproduce:

Click "New"

Enter "TEST" and "Test" for short name/name

Enter a url to some XML

Click "Save"

This will lead to a page with a red box around the schema and message:

Please specify the target pat and schema for the given resource. 

This isn't very helpful; it would be mroe helpful if it said something like: 
"You didn't provide a schema, so we have inferred one that seems to work for 
your document.  Click "Save" if this is OK, or edit the schema."

Original issue reported on code.google.com by [email protected] on 24 Feb 2011 at 4:00

RDF export

1. Add capability to export entries (or parts of entries) as RDF.  

2. Add capability to export provenance, annotation, history information as RDF, 
cross-linked against the data.

Original issue reported on code.google.com by [email protected] on 23 Nov 2011 at 2:33

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.