plumed2 icon indicating copy to clipboard operation
plumed2 copied to clipboard

New manual

Open GiovanniBussi opened this issue 5 years ago • 3 comments

@maxbonomi has worked on a new layout for the manual (see branch plumed-manual-2019). It looks difficult however to compile it on travis-ci.

According to what the developer of m.css says, it requires a recent latex version that is not available on travis-ci. He suggested switching to ubuntu 16 (see #504 ) could allow compiling, but the layout would not be good, again due to an old latex version. Possible alternatives:

  • using OSX on travis-ci to build the manual (not sure, travis-ci/OSX is alway a bit unstable and with low availability)
  • using ubuntu 18 if its latex is recent enough
  • directly install a recent latex on an older system

Notice that to build the full manual we need anyway to make sure all the features of the code can be enabled (some parts of the manual are only shown when linking some libraries).

GiovanniBussi avatar Aug 02 '19 10:08 GiovanniBussi

Do we know the exact minimum latex version required? Or at least a version that works?

carlocamilloni avatar Aug 02 '19 11:08 carlocamilloni

versions from late 2017, at least - this is what the m.css developer says

On Aug 2, 2019, at 13:43, Carlo Camilloni [email protected] wrote:

Do we know the exact minimum latex version required?

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

maxbonomi avatar Aug 02 '19 12:08 maxbonomi

Just a note on this: as of 5aa53c2067db7d64fbf5e6b6b63bf68a97dad60b (already merged on v2.6) the job that builds the manual is running on Ubuntu 18 bionic.

GiovanniBussi avatar Jan 03 '20 10:01 GiovanniBussi