calzada / PARLAMINT-ES-MC

2 stars 4 forks source link

Improve readme.md #34

Closed calzada closed 1 year ago

calzada commented 1 year ago

@OceanicFlight

Could you check the readme.md is documented properly. Do we need to specify anything else? If so, Could you added yourself in the Readme.md, pliz

https://github.com/calzada/PARLAMINT-ES-MC/blob/master/README.md

Thanks!!!!

OceanicFlight commented 1 year ago

2. Conversion to TEI format (Tomaz Erjavec)

2.1 Translating ECPC XML to TEI formate with Parlamint Makefile.

NOTICE Implementation can be placed in cd2parmamint.xsl or in a separate script (then Makefile modification is needed)

Notice Makefile steps should be implemented from bottom to top. Targets are run with "make" command and the target (for instance: make cnv1).

If you are working on Windows, it is advisable to install a Windows Subsystem for Linux (WSL) to use bash command-line tools on Windows and run makefile smoothly. Several errors will crop up while trying to run the makefile.

2.0. Enable WSL

Open Windows Features, scroll down and check Windows Susbsystem for Linux. Select OK and restart Windows.

2.1. Open PowerShell or Command prompt (terminal) as an administrator (right click)

type wsl --list --online to view a list of available WSL distributions that can be installed

2.2. Type the specific distribution (for example, Ubuntu): wsl --install -d Ubuntu and press enter. Restart your computer

2.3. After restarting, it may take a while to install your desirable distribution.

2.4. Once installation of Ubuntu is complete, you'll be prompted to enter your username and password

2.5. Launch Ubuntu from the start menu on Windows

2.6. Do apt upgrade and apt update

Update by typing

$ sudo apt-get update

you'll be prompted to enter your password (step 7)

10º Upgrade

$ sudo apt-get upgrade

2.7. Install packages and dependencies (you'll be prompted several times "Do you want to continue? [Y/n]" type Y)

$ sudo apt install moreutils $ sudo apt install make $ sudo apt install parallel $ sudo apt install openjdk-19-jre-headless $ sudo apt install unzip

One script is loaded from the Ukrainian ParlaMint repository (you need to have svn installed for that. $ sudo apt install subversion

$ sudo apt install jing

2.8. Saxon needs to be in the right place. This setup works (you should place SaxonHE12-3J here): /opt/SaxonHE12-3J/saxon-he-12.3.jar -rw-r--r-- 1 root root 5559891 Jul 12 11:45 /opt/SaxonHE12-3J/saxon-he-12.3.jar

go to /otp and make a dir to install SaxonHE12-3J.zip

$ cd /otp $ sudo mkdir SaxonHE12-3J

Download SaxonHE12-3J.zip from [https://www.saxonica.com/download/] and move the file to /otp/SaxonHE12-3J

$ sudo mv /mnt/c/Users/XXXXX/Downloads/SaxonHE12-3J.zip /opt/SaxonHE12-3J

where XXXXX is your windows username

14º Unzip SaxonHE12-3J.zip

$ cd /otp/SaxonHE12-3J $ sudo unzip SaxonHE12-3J.zip

And then you must create a symlink here and verify

$ sudo ln -s /opt/SaxonHE12-3J/saxon-he-12.3.jar /usr/share/java/saxon.jar

matyas@mPC:~$ ll /usr/share/java/saxon.jar lrwxrwxrwx 1 root root 35 Jul 12 11:52 /usr/share/java/saxon.jar -> /opt/SaxonHE12-3J/saxon-he-12.3.jar saxon.jar in the right place: /usr/share/java/saxon.jar

Notice you should use Saxon-HE, because it allows you to run XSLT2.0 scripts

Now you can run makefile.

OceanicFlight commented 1 year ago

done

El mié, 2 ago 2023 a las 22:18, calzada @.***>) escribió:

@OceanicFlight https://github.com/OceanicFlight

Could you check the readme.md is documented properly. Do we need to specify anything else?

https://github.com/calzada/PARLAMINT-ES-MC/blob/master/README.md

Thanks!!!!

— Reply to this email directly, view it on GitHub https://github.com/calzada/PARLAMINT-ES-MC/issues/34, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB4HQC3MZY3AUJB2QPWOPNDXTKYYFANCNFSM6AAAAAA3BZARVM . You are receiving this because you were mentioned.Message ID: @.***>

OceanicFlight commented 1 year ago

I merged your annotations with mine, you can replace point number 2.1 with what's been posted above

calzada commented 1 year ago

@OceanicFlight

Please could you read README.MD and check whether it is ok. What is 10º and 14º? If it is not necessary, please replace with proper numeration IN README.MD itself by clicking on the pencil to edit. Cheers. MC

calzada commented 1 year ago

Done!!. Issue closed.