abcd-devcom / abcd2

ABCD v2.x based on CISIS

ABCD v2.x based on CISIS

Welcome to the development of the ABCD!
Explore the ABC of ABCD »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Installation
3. Usage
4. Contributing
5. License
6. Contact

About The Project

Acronym ABCD stands for:

Automatización de Bibliotecas y Centros de Documentación
Automation des Bibliothèques et Centres de Documentacion
Automatização das Bibliotecas e dos Centros de Documentação
Automatisering van Bibliotheken en Centra voor Documentatie

ABCD was initially developed by Bireme with the support of VLIR/UOS and based on UNESCO-supported ISIS-technology. Currently the development is solely done by volunteers in several countries but not enough thanks can be given to G. Ascencio and E. Spinak.

---

The name itself already expresses the ambition of the software suite : not only providing automation functions for the 'classic' libraries but also other information providers such as documentation centres. Flexibility and versatility are at the forefront of the criteria on which the software is developed. This flexibility e.g. is illustrated by the fact that in principle, but also practically, any bibliographic structure can be managed by the software, or even created by itself. Even non-bibliographic structures can be created, as long as the information is mainly 'textual' information, as this is the limitation put by the underlying database technology, which is the (CDS/)ISIS textual database. Good understanding of some basic ISIS-related concepts and techniques, e.g. the Formatting Language, is crucial for full mastering of the ABCD-software. For this reason some sections of this Manual will also deal with the underlying ISIS-technology.

ABCD is called a 'suite' of softwares for library and documentation centres automation because it exists of some relatively independent modules, which can fully co-operate but also can exist without each other. In fact some existing advanced softwares, mostly having already shown their potential in demanding environments in BIREME- applications (within the Virtual Health Library context), were adopted and adapted into ABCD - that is why the original names such as iAH, SeCS (both developed by BIREME) and EmpWeb (Empréstimos en Web) developed originally by KALIO ltda. of Uruguay and amply tested in Valparaiso at the University) are maintained. These main parts are shown, with their hierarchical relationships, at the second level in the following picture:

Built With

ABCD is being written using the languages.

• PHP
• CISIS
• HTML
• JavaScript

Installation

ABCD is supported on Windows and Linux
Download the latest ABCD release
Download all code from GitHub ABCD-DEVCOM / ABCD2

Installation prerequisites and installation procedure vary by version and by installed components. See Installation folder for detailed instructions and material. Note that the ABCD downloads do not include software prerequisites

Download EmpWeb

EmpWeb has additional prerequisites (SQL,Java). Details in the repository.

Usage

You can try the ABCD software on an online installation of the ABCD. All features that you can access come with the default installation package of ABCD.

Our demo version is synchronized with the development in the Github repository, so there may be some bugs.

We will soon make a more stable demo version available in parallel with development for comparison

Instructions To enter the modules, you shall follow the instructions below:

ABCD – Administration – http://demo.abcd-community.org/

Rights: System Administrator, Database administrator, Database Operators, Loan administrator

User: abcd
Password: adm

Rights: Database administrator, Database Operators

User: abcd
Password: dboper

ABCD – Public site – https://demo.abcd-community.org/site/

ABCD – Public site administrator – https://demo.abcd-community.org/site/admin

Rights: Administrator

User: adm
Password: x

For more examples, please refer to the Documentation

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/ABCD2)
3. Change or create a file (git add [files changed] or : git add . (for all files))
4. Commit your Changes (git commit -m 'Add some ABCD2Feature')
5. Push to the Branch (git push -u origin master)
6. Open a Pull Request

• to push to branch : git push -u origin [name-of-branch]
• to pull from master to local copy : git pull origin master
• to change from master to branch : git checkout master/branch

License

ABCD is an application of software released to the public according to the terms of the LGPLv3 license, taking into consideration the disclaimers to protect BIREME and other institutions participants on any liability regarding the access, development, distribution, use, merchantability and marketing related to the software;

ABCD reuses several other libraries and modules. These dependencies retain their original licenses.

For those interested in more information about the licensing, check http://www.opensource.org/licenses/alphabetical.

For a comparisom between software licenses, check http://en.wikipedia.org/wiki/Comparison_of_free_software_licences.

Contact

E-mail - [email protected]

Project Link: https://github.com/ABCD-DEVCOM/ABCD2/

Website: https://abcd-community.org/

abcd2's Issues

Error: Translation message with double quotes

Hello,
I noticed a problem in /central/lang/translate.php when the translation has double quotes.

The sentence is broken in the quotes when I send the translation.

MX

mx is giving me trobules I have windows 10 64bits

so what can i do im using defender and it need to work in 64 bit not in 32

Windows: Global Change UTF-8 gives error when a field is deleted

Global Change -> (any record, any field) -> Type of change="Delete field" -> (specify contents) -> "Execute".

• This works correct on ISO-8859-1 databases (Windows & Linux)
• This works correct on UTF-8 databases (Linux)
• Shows an error and the action is not executed on Windows UTF-8 database
  Error:
  

Inverted File Generation (MX) does not show needed information

1. A standard (correct run) gives output with a "Test"link:
   
   But the "Test" link tests the default mx and not the actual used mx
   

2. Note that a correct working link and test on the existence on the initial screen would be more informative as a missing executable results in "Process NOT EXECUTED" without further indications

3. Errors from the executable are not shown in the result window. Examples::
   fatal: loaductb_utf8/it is not in ascending order
   fatal: loaductb_utf8/number gt 3 chars

Add data folders opac and opac_conf to this repository

Source is ABCD22_Linux_amd64.deb

Add/merge gizmo and gizmo_UTF8 files from "abcd 2.2 beta" in this repository.

Source from ABCD22_Linux_amd64.deb and ABCD22_Windows.zip

errors in fst test

fst is not working when i test fst in upgrade databse

iah on windows

On iah.xis this line the variable v7666 should have the value of 'Win' but instead it is NULL:

Full repository cannot be used in Windows because standard Windows filenames are not case sensitive

Unpacking a zip warns about duplicates and pathnames that er too long

GitHub Desktop on windows accepts this but may conclude that the file is changed.

Preliminary solution: use GitHub Desktop only on Linux.

Unzip at the top of the filesystem to avoid pathnames that are too long

Best solution would be Windows with case-sensitive names and longer pathnames. A short survey did not reveal a good workaround.
Inspection of some found duplicates show that it is also possible to delete one of them. Easy examples:

• bases-examples_Linux\agrovoc\pfts\en\rt.pft -> RT.pft differ in line endings only
• bases-examples_Linux\marc\def\pt\countries.tab -> .TAB has more entries=not used. .tab of windows is equal to linux
• bases-examples_Linux\marcuni\def\pt\countries.tab -> .TAB are equal=not used
• bases-examples_Linux\reserve\marc0\def\pt\countries.TAB -> .TAB has more entries=not used. no windows equivalent
• bases-examples_Linux\stock\pfts\en\checkbarcodesMFN.pft -> very different mfn is not used
• bases_examples_Windows\stock\pfts\en\checkbarcodesMFN.pft-> very different mfn is not used
  More problematic:
• dhtmlxgridCell.js. -> Many variants exist (find . -name dhtmlridell.js -exec ls -l {} ; ). Grep delivers usage information (grep -iR dhtmlXGridCell.js ). There are several more files in the dhtml.js category: dhtmlxgrid.js, dhtmlXGrid_skins.css, dhtmlXGrid_dhx_web.cs, dhtmlXGrid.css
• A strict check for semiduplicates for other filenames is required. A quick revealed >25 warnings from unzip.

Inverted File generation (MX) does not work correct for UTF8

Reproduction is possible on Windows & Linux :

• Set database "experts" to accept unicode by update of dr_path.def
• Perform inverted files generation by MX of from the commandline. This does NOT show any errors
• Click the "search" icon
• Click "index" after Words. This shows the terms and note that many terms are no converted to uppercase.
  
• Clicking an uppercase term works as expected. A mixed case term , e.g. "Activities", and "Search" shows unexpected effect:
  

The original https://github.com/ABCD-DEVCOM/ABCD2/blob/master/www/bases-examples_Linux/isisuctab_utf8.tab and variations are tested. All without result.
This file looks OK and is supposed to work.
Experimenting with this file revealed that it may still contain undetected syntax errors. Following test entries (not present in the actual file) were not detected:

• this is rubbish
• 01=

The command line does not show any errors. Example run:
/opt/ABCD2.2/www/cgi-bin/utf8/mx /var/opt/ABCD/bases/experts/data/experts fst=@/var/opt/ABCD/bases/experts/data/experts.fst fullinv=/var/opt/ABCD/bases/experts/data/experts -all now tell=100
+++ 545+3 links
+++ data base: /var/opt/ABCD/bases/experts/data/experts
+++ .lk1 file: /var/opt/ABCD/bases/experts/data/experts.lk1
+++ .lk2 file: /var/opt/ABCD/bases/experts/data/experts.lk2
+++ /var/opt/ABCD/bases/experts/data/experts.lk1
+++ 100 FT_Research
+++ 200 FT_de
+++ 300 FT_is
+++ 400 FT_p
+++ 500 FT_strong
+++ /var/opt/ABCD/bases/experts/data/experts.lk2
+++ 4/0

Note: Database MARCUNI works at first sight as expected. BUT the problem is hidden by the FST that contains the "mpu" term for all search definitions.

missing files

i was indexing in abcd

document root

where is the document root in wamp ? because i cant see it

password and user id not working in these version not even with abcd as user id and password adm

Import digital documents ; the case of images

I tested importing a .jpg file, which is indeed also processed by Tika.
The result is fine, with a link to the image immediately being available.
My only concern is the fact that the resulting html-file has still real contents but only in the '' tags, meaning the text-preview doesn't show anything. The presentation of that text-preview should be made conditional on the 'size of v95' being >0, as was the case in the previous version of DubCore (with the previous docbatchimport.php script) but even with that in place here an empty preview box will be present. So the tags should be avoided in the output-html file ?
Example of such meta-tags output from a jpg-image :
'









'... etc.

error in file convert_txt.php

the file is showing the error message

Fatal error: Uncaught Error: Call to undefined function mb_detect_order() in /ABCD2/www/htdocs/central/utilities/convert_txt.php:148 Stack trace: #0 {main} thrown in /ABCD2/www/htdocs/central/utilities/convert_txt.php on line 148

saving PFT files from Database definitions menu problem

The 'function enviar()' at line 85 of the script dbadmin/leer_txt.php :
window.opener.document.forma1.pft.value=esc(document.forma1.pftedit.value)
no longer seems to work correctly in both Windows and Linux.
This prevents edited PFT's from being saved ('sent') to the file-system.

Add/merge lang files from "abcd 2.2 beta" in this repository.

The addition of OPAC caused the addition of some new language tables. Other tables are extended due to OPAC and other improvements. The first beta2.2 distribution had these in folder "bases-added". Goal is to complete the set of language records for '00' and , if available, also for other languages.
All current tables will be sorted in order enable more efficient comparisons in the future.
Old and saved table files will be removed.
This issue does NOT cover translations of added language records to other languages

Add/merge code files from "abcd 2.2 beta" in this repository.

Primary source is ABCD22_Linux_amd64.deb.
For windows specific code the source is ABCD2.2b_for_Windows.zip

Add/merge par and par/profile files from "abcd 2.2 beta" in this repository.

EmpWeb not passing on UTF8 strings correctly to the IsisWrapper mx-command

In fact when doing a query in the bibliographic database or the ISIS-users database, an mx-command is constructed which passes on the search-string as the 'BOOL=' parameter for mx. It seems when that query contains non-ASCII characters still they are not transferred on correctly as this passes through the terminal. This can be seen from the log-files. So, querying a UTF8-database will work but only with ASCII-character search terms.

winisis is not working for a new database

i hope you check it

EmpWeb failing with CISIS UTF8 due to 'uctab=ansi' parameter hard-coded

In the 'mxIsisWrapper.class' of EmpWeb an mx-command is build, which includes - in my opinion completely unnecessary since it is only about searching a catalog record - the hard-coded parameter 'uctab=ansi'. This causes the command not to work in CISIS UTF8 (ABCD2.0) since that parameter there is rejected.
Solution : re-building the empweb-common-lib.jar (in empweb/common/lib) with a newly compiled mxIsisWrapper with uctab=ansi parameter removed.

Expanding of summary not working

In the 'old' ABCD there is an option to expand or collapse long fields, e.g. the abstract of a item.
This is reported as "not working anymore" - It might be that the code is missing?

The display format is like this:
display-format.txt