LiquidJournals
From LiquidPubWiki
Contents |
Intro
This page contains description of the functionalities of the latest version of the prototype of Liquid Journals. It also describes how to contribute to development of the prototype.
How to contribute to development
- The code fo the prototype is available here
- You can submit a bug or create a feature request at Pivotal Tracker
Project Organization
- web/extjs : ExtJs library
- web/html : html files for header, footer, and layouts
- web/script : all java script files
- web/script/data : data handlers for managing the communication with the backend
- web/script/layouts : here is defined all the layouts. Each layout register the widgets that will render and manage the communication between them through the EventBus handler.
- web/script/proxy : proxy files that is used to interfaces with the backend rest service (LJClient).
- web/script/widgets : all the visual components are defined in this folder.
- web/script/workflows : here is defined the workflow of layouts.
- web/theme : css, images, and icons.
Other development artifacts
Stories
Liquid Journal are being developed to support the following stories:
Description of features
Filling LJ with content
via e-mail
Currently two types of requests are available for testing purposes:
NOTE: this works via email, meaning you need to send a email to a specific account
1+ Querying scholar by writing the query to: liquidjournal@disi.unitn.it subject: <the query you want to execute on scholar> e.g., web services RESULT: first match
2+ Getting info about a paper by sending a picture to: liquidjournal@disi.unitn.it subject: image attachment: the picture of the title of the paper RESULT: first match - (The parser can actually work with arbitrary number of results and extract the relevant metadata).
The idea of the second request is that you can take a picture of a paper (the part with title and authors) with your mobile phone and add to your liquid journal by sending image via e-mail.
The code and server scripts can be found at [1]
In the Cooking Area
There is a button "Add resource" in your cooking area section.
Firefox "Plugin"
There is a user script for the Firefox Greasemonkey plugin, that allows you to add resources to your liquidjournal.
Works with
- Google Scholar result page,
- Springer result page,
- Springerlink resource page and the search result page(condensed view),
- Google Docs, when editing the document.
How to use
- Dowload and install the Greasemonkey plugin for firefox.
- Checkout the addtoliquidjournals user script from the repository (use lp-guest and lp-password).
- Open the file you downloaded at the previous step in your Firefox (through File->Open menu, or just drag-and-drop): there will appear an installation window.
- Press "Install".
- Open one of the supported pages.
Latest updates
- Added the possibility to chose the liquidjournal you want to add the resource to,
- Added support for Springerlink and Google Docs.
Current issues
- In Springer, doesn't parse the authors (because the format is a mess),
- Doesn't recognize resource type and representation format (has them hardcoded),
- Allows to add resource only to one liquidjournal,
- If you don't log in properly, it annoys you with the alerts on each new search/page refresh,
- Doesn't allow you to log out. In order to log out you have to
- type about:config in your firefox address bar,
- on the page opened, find the preference with the name greasemonkey.scriptvals.lj/AddToLiquidjournals.addtoliquidjournal.user.email (you can use search)
- set its value to empty string
- refresh your search page.
Web UI
You'll find the latest version of the liquid journal's at [2]
It is not completely functional but you can already:
Reading
At Reading tab you can:
- visualize your journals
- see the list of journals you are following
- see your tags, and drag and drop them to the resources of your subscriptions
- add a resource to your journal using drag and drop
- filter resources from your subscriptions by author, resource type, format type, publication date
- go to journal cooking area by clicking on the journal you follow or run
Journal tab
At Journal tab you acces a cooking area of a journal where you can:
- create your liquid journals
- access the cooking area and drag&drop the elements into the (not published solid OR liquid ) issues
- create issues
- browse your issues and visualize their content
- manually add scientific resources, putting the title and the URI
Current issues
- User id is currently hard coded, no login
- we need to work on the display and editing of labels
- labels might not display on journals
- we cannot visualize issues | editors | or any other resource with one item due to some problems on the API, but Daniil and Michele are
working on this
- you cannot add other editors right now
- the navigation path is accumulating the layouts, so replicating the path..
- it is not aesthetically NICE, but we'll iterate on this
Widgets
To show content of your liquid journal in a widget, you embbed this url into an iframe: http://liquidjournal.org/widget.php?name=ljres&ljId=3808
https://dev.liquidpub.org/svn/liquidpub/prototype/liquidjournals/ljweb/web/widget.php https://dev.liquidpub.org/svn/liquidpub/prototype/liquidjournals/ljweb/web/html/widget.html https://dev.liquidpub.org/svn/liquidpub/prototype/liquidjournals/ljweb/web/html/layout/myljLayout.inc
the url to insert in the iframe is:�http://liquidjournal.org/widget.php?name=mylj&userId={id}
Next in the plan
- add the possibility of adding relations (creating the graph)
- add the possibility of publishing issues
- add sharing
