search

KWARC / LaTeX-proposal

The Proposal package for LaTeX
66 stars 34 forks source link

How to get started (for non-experts)? #33

Open fangohr opened 6 years ago

fangohr commented 6 years ago

Hi team,

I have used the LaTeX-proposal class before, but didn't have to set it up. I am trying to advocate use of this convenient LaTeX-proposal class for a group of people. However, making the first step seems quite hard at the moment (for LaTeX users who are not experts).

Would it be possible to give more guidance on how to get started? For example, before/after having cloned the proposal class in the directory demo (for example) like this:

cd $HOME
mkdir demo
cd demo
git clone https://github.com/KWARC/LaTeX-proposal.git

what "cp" commands does one need to carry out to compile the EU example proposal shown in https://github.com/KWARC/LaTeX-proposal/blob/master/eu/examples/strep/propB.pdf ? Which command should be used (and in which directory to trigger compilation)? We may also have to adjust the paths in the Makefile in the strep directory.

It would be great to have a minimum working example for this to build on. Thank you!

sieversMartin commented 6 years ago

Am 22.11.2017 um 18:40 schrieb Hans Fangohr:

Hi team,

I have used the LaTeX-proposal class before, but didn't have to set it up. I am trying to advocate use of this convenient LaTeX-proposal class for a group of people. However, making the first step seems quite hard at the moment (for LaTeX users who are not experts).

Would it be possible to give more guidance on how to get started? For example, before/after having cloned the proposal class in the directory demo (for example) like this:

cd $HOME mkdir demo cd demo git clone https://github.com/KWARC/LaTeX-proposal.git

what "cp" commands does one need to carry out to compile the EU example proposal shown in https://github.com/KWARC/LaTeX-proposal/blob/master/eu/examples/strep/propB.pdf ? Which command should be used (and in which directory to trigger compilation)? We may also have to adjust the paths in the |Makefile| in the |strep| directory.

It would be great to have a minimum working example for this to build on. Thank you!

There is a version on CTAN. This one is available in TeX Live and MiKTeX. So, there is usually no need to install something manually. You can start right away.

Best regards Martin Sievers

kohlhase commented 6 years ago

I am afraid that the CTAN version is quite a bit behind the github version. I should really make a CTAN release.

kohlhase commented 6 years ago

But I agree that a copy-me script would be helpful. I will see what I can do in the next days.

fangohr commented 6 years ago

Hi Martin and Michael,

first, many thanks for the quick responses.

Martin, that's useful information. I downloaded http://mirrors.ctan.org/install/macros/latex/contrib/proposal.tds.zip, unzipped it, went to proposal/doc/latex/proposal/eu/strep, tried pdflatex propB.tex which stops with 

! LaTeX Error: File `../lib/WApersons.tex' not found.

Type X to quit or  to proceed,
or enter new name. (Default extension: tex)

Enter file name:

One could start debugging from here, but it would be nice to have a recipe that works out of the box.

Michael, the copy-me script would be great. Maybe we can even put a (Docker) container together in which we install the required dependencies, the run the script, then compile the example as a kind of system test. We could link this to Travis and your Github repo, and this could give your project a green build badge ;). [I can likely help with some of that.]

sieversMartin commented 6 years ago

Am 23.11.2017 um 10:35 schrieb Hans Fangohr:

Hi Martin and Michael,

first, many thanks for the quick responses.

Martin, that's useful information. I downloaded http://mirrors.ctan.org/install/macros/latex/contrib/proposal.tds.zip, unzipped it, went to |proposal/doc/latex/proposal/eu/strep|, tried |pdflatex propB.tex| which stops with

! LaTeX Error: File `../lib/WApersons.tex' not found.

Type X to quit or to proceed, or enter new name. (Default extension: tex)

Enter file name:

One could start debugging from here, but it would be nice to have a recipe that works out of the box.

You should check your distribution's (TeX Live or MiKTeX) package manager and install the proposal package from there. Then everything should be in place and "texdoc proposal" and "texdoc dfgproposal" will give you first examples.

Best regards Martin

--

Martin Sievers -- Einfach schöner publizieren

Im Alten Garten 5 54296 Trier

Telefon: +49 (0) 651 4936567-0 Telefax: +49 (0) 651 4936567-9 Mobil: +49 (0) 179 7347726

Internet: http://www.schoenerpublizieren.de E-Mail: info@schoenerpublizieren.de