##### Child pages
• Aalto University publication series template
Go to start of banner

# Aalto University publication series template

Go to start of metadata

(Note. Aalto series whole package (both series template and logo package) can be downloaded from here:https://version.aalto.fi/gitlab/latex )

The aaltoseries LaTeX class provides the definitions to be used in publications published in the Aalto University publication series. The layout recommendations for the Aalto University publication series are implemented by the class. In addition, the class provides a selection of commands and environments for an easy-to-use access of the features of different publication types.

Aalto University has five publication series for university’s own publications. Each of these series are dedicated for a certain topic. Three publication series are named after the large research and teaching topics of Aalto University and they are "Business + Economy", "Art + Design + Architecture", and "Science + Technology". In addition, there is a series "Crossover" for multidisciplinary publications and a series "Doctoral Dissertations", as its name suggests, for doctoral theses.

The aaltoseries class uses the aaltologo package. Therefore, it needs to be installed too, consult the documentation of the aaltologo package for instructions.

The aaltoseries class been verified and approved by the designers of the Aalto University publication series guidelines, making it the official LaTeX implementation of the Aalto University publication series.

The aaltoseries class has been published under the Creative Commons Attribution No-Derivative license (http://creativecommons.org/licenses/by-nd/1.0/). This means that you can use the class freely in your own documents but it also means that you cannot base your own Aalto University publication series class/package upon this class. However, you can use this class as an example in designing your own classes/packages that implement the publication series recommendations of another university or company.

The class is distributed through Aalto Git repository and contains the following files and directories:

• aaltoseries.cls - The class file that provides the LaTeX definitions used in the Aalto University publication series.
• aaltoseries.pdf - The documentation of the class (that it, of the class file)
• LISENCES.txt - The publication licenses of the class and the documentation
• README.txt - A very short description of package contents
• examples/ - A directory that contains the example codes for the features presented in the class documentation

The latest version, derived from the git repository, can be downloaded as a zip file form here. The latest version is in git, at https://version.aalto.fi/gitlab/latex/aaltoseries.

Instructions to LyX users

If you encounter problems when using the package, consult first the troubleshooting pages of the aaltologo package and the aaltoseries class, and the known issues page of the aaltoseries class before contacting the class maintainer. As these pages may not be 100% up to date, it's OK to contact the maintainer if you're still puzzled after that.

1. Any news on this? Feb 4 was two months ago...

1. Now it has been published. Finally.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

2. It would be beneficial for all if the keywords dissertation or thesis would be mentioned somewhere on this page (not only within a pdf hidden in a zip). Also links from dissertation instruction pages such as that of Electrical Engineering (in all languages) would help the postgraduate students.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

1. Hi,

It's a bit out of context. But I'm wondering how to get the language check done for the manuscript. Are there any Aalto collaborators that help with it or is it completely candidate dependent?

3. It would also be good to have some type of policy with the \bibliographystyle. In the old environment, we used tkkdiss, now there seems to be some policies set by different schools but not really defined in a public instruction page.

1. The reason why there isn't any instructions on this is that every field of science has their own style for bibliographies. Therefore, this template will not make any assumptions on this issue and the user is required to choose an appropriate style for his/her document.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

1. How do I even add a bibliography to my dissertation? One way to interpret the situation: template does not have bibliography => a dissertation cannot have bibliography (or citations other than my own published papers).

I have this separate dissertation.bib file, which I included (before \errata in dissertation.tex) with \bibliography{dissertation}

, but LaTeX still produces errors like "LaTeX Warning: Citation Xyz2011' on page 11 undefined on input line 75."

1. Now I don't follow. Of course you can have a bibliography in your dissertation, and I think it is even highly desirable...

Remember that when you include your bibliography from a BibTeX file, you need to compile the document a few times in order to get citations correct (and get rid of those warnings):

latex dissertation.tex
bibtex dissertation.aux
latex dissertation.tex
latex dissertation.tex


If you still encounter a warning that a citation is undefined, you most likely have a typo in the argument of a \cite command. And of course you can use the pdflatex compiler instead of the latex compiler if you prefer that.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

1. The first comment is related to the fact that running grep bib *.tex in the examples directory does not find any matches. Maybe I have an old version or something.

Secondly, \bibliography command does not seem to work. I'll need to find out why...

1. Check the latest version. There is a file specialthings.tex, which has an example of including a bibliography using the \bibliography command.

I recommend that you update the class file to the latest. If you still encounter a problem, please contact me, include the files you are using as well as the description of the system (operating system and LaTeX distribution) you are using.

Jussi Pekonen, maintainer of the package, Department of Signal Processing and Acoustics

2. OK, \bibliography works after all and the result looks fine. I just had to fix \bibliographystyle before that, and add one missing record to the .bib file.

LaTeX is not the most elegant tool (in terms of informative output or error handling), but maybe it's still the best out there.

4. Thanks for replies. Another problem: the \addpublication command has the "optional" argument <type>, which I assume is quite compulsory in a dissertation. Where are the possible values for <type> listed, the aaltoseries.pdf only tells of conference.

Frontmatter and mainmatter seem not to work in this documentclass. Are they really to be omitted, they have use e.g. in organizing the page numbering?

1. If your publication is a journal paper or a report, you can omit the optional argument. The optional argument is used to add some text before the publication name (like the word "in" before the proceedings name in the case of conference papers), more details can be found from the documentation, from Section 4.4.1 (pages 17-18 at the current version of the documentation).

If you want to change the page numbering, you need to set that by hand, like this:

% Set the page number to one, or whatever you want
\setcounter{page}{1}
% Set the numbering style, where <style> is one of the following: arabic, roman, Roman, alph, Alph
\pagenumbering{<style>}


The aaltoseries class does not use the "old" commands that were available in the tkkdiss class because the publications done with this class are more diverse than one could produce with the tkkdiss class.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

1. The aaltoseries class does not use the "old" commands that were available in the tkkdiss class because the publications done with this class are more diverse than one could produce with the tkkdiss class.

OK. Where are the publication type specific instructions located then? Google does not find them, if they exist.

I am not saying this would be your responsibility, but I sure hope someone is tasked with this.

1. Now I don't follow. The class documentation (aaltoseries.pdf, distributed with the class file, in the zip archive) has Section 4 "Publication type specific features" where the features of the class for different publication types are described. Please refer to that.

One should note that code that generated non-standard LaTeX items with the tkkdiss class should not be used when one is using the aaltoseries class. Many things, and there are very many, have been redesigned (mainly to be more user friendly) and the command and/or environment names for those are completely different from the tkkdiss class. These differences will then cause many errors and warnings. Getting rid of them requires that every single error source is replaced with a command/environment that is available in the aaltoseries class.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

5. Is there any guide on how the abstract is formatted within an Aalto dissertation? The old tkkdiss document class had a series of commands that created the abstract. These seem not to be usable in aaltoseries.

1. See Section 3.1.2 on page 9 and Section 3.4 on page 12: the aaltoseries class is not used to typeset the abstracts of the Aalto publication series because they are typeset using the Aalto publication platform at which the publications are ordered. For drafting the aaltoseries class provides a command to typeset the abstract, see Section 3.4.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

1. This document (aaltoseries.pdf) would sure benefit if it had examples.

For instance, this \draftabstract is poorly presented. How should one use it? It seems not to be

\draftabstract{dsniedf woejoiemjfe ...}



nor

\draftabstract

\begin{abstract}

dsniedf woejoiemjfe ...

\end{abstract}



and from the text it seems not to be

\begin{draftabstract} ...

dsniedf woejoiemjfe ...
\end{draftabstract}


either.

1. Have you checked the example files in the examples/ folder?

The correct format is the first one.

\draftabstract{text}


Note that the command also accepts an optional argument with which one can set the language of the abstract.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

6. Dear all,

I would like to write my PhD thesis using the aaltoseries package. Is there a possibility to generate a title/cover page? I understood that \maketitle is switched off. Thanks in advance!

Gijs

1. As said in the class documentation (and above), the front matter (title, abstract(s), etc.) are typeset using the Aalto publication platform at which the publications are ordered. Note that you can collect the publication material (title page, abstract(s), and the manuscript text) as a PDF file without ordering the publication. So, you should use the publication platform to add a title page to your publication.

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

1. Its a bit unclear. Can you post the exact link here to Aalto publication platform where we can order the title page?

1. https://automation.digtator.fi/Aalto/UserContentStart.aspx

You need to have ready the text of the dissertation (PDF) and the abstract in the suitable format which you can also produce in LaTeX using draftabstract option. The platform will do the complete processing. But you can interrupt the process at any point. No hätä

7. Hi Jussi,

Thanks for your quick reply. I added the draft option to the document class and that generates a draft title page, which was what I was looking for. In case anyone needs the publication platform as well, it lives here: https://inside.aalto.fi/display/AboutAalto/Aalto+publication+series

Cheers,

Gijs

8. Is it intentional that draft mode hides epsfig pictures?

1. From the class documentation: The option draft sets the draft mode on in the aaltoseries class and in all included packages that have a draft mode. This means that the epsfig package ﻿[1] accepts an option "draft" that suppresses the figures to be included. In order to use the draft mode without affecting the packages you include, give a class option "draft*" (note the asterisk).

Jussi Pekonen, class developer and maintainer, Department of Signal Processing and Acoustics

﻿[1] Note that the epsfig package is nowadays obsolete, see http://www.ctan.org/pkg/epsfig. It is recommended that you use the graphics or graphicx package instead.

1. Thanks! Another question: the report class type seems to ignore centering for the captions, how to deal with that? I am using tabular inside a table and center with centering. The same thing occurs with figure environment and it looks strange that the table/figure is in the middle but the caption is indented left.

1. First of all sorry for the delay. I was on a vacation when you posted your comment, so I forgot to answer to your question.

The centering or indentation of the caption text is a design choice. In aaltoseries class all text is left indented (actually, it is justified), which means that centered text would get a visual emphasis on a page. In some cases that may be desirable, but in the guidelines of the Aalto University publication series such visual emphasis isn't advised to be used. Therefore, the aaltoseries has been intentionally disables this feature.

However, if you absolutely want that feature, you need to read the documentation of the caption package and play with the aaltoseries class file. I won't give more details here due to the reason given above.

Jussi Pekonen, class developer and maintainer (Department of Signal Processing and Acoustics)

9. I am using Kile ver. 2.1.0 to run the dissertation.tex. It gives the following error:

./aaltoseries.cls:599:Package xkeyval Error: 'textformat' undefined in  families 'caption' ...font={AaltoSeriesCaption},labelfont={bf}}


Does anybody know how I can get rid of this error?

Thanks,

Mikail

1. I suspect that your LaTeX-distribution has an outdated version of the caption package. Send me (my email address can be found from my profile page) the log file (that is, dissertation.log) so I can check version compatibilities. I can then give you more a detailed answer and update the known issues page.

Jussi Pekonen, class developer and maintainer (Department of Signal Processing and Acoustics)

10. simple question: I cannot see the title. I just download everything and set in Lyx the document class with local layout to "aaltoseries". It mostly works, but I just cannot see the title and author I added in there.

1. The front pages (title page, abstracts) are typeset in the publication platform, so by default the aaltoseries class does not print those. When you set the draft mode on with a class option 'draft' or 'draft*' (see the class documentation for the difference between them), the class prints the title and author information for drafting purposes.

Jussi Pekonen, class developer and maintainer (Department of Signal Processing and Acoustics)

11. I am using the packages amsmath and natbib with the aaltoseries document class. I'm also using a third party bst file attached: elsarticle-harv.bst.

Before starting my work I just copied aaltologo.sty and aaltoseries.cls into my work folder. I'm working on the TeXWorks environment for Mac.

When I run pdfLaTeX, bibtex, and then pdfLaTeX again for the second time, I get the following error:

! Package inputenc Error: Unicode char \u8:‐ not set up for use with LaTeX.

As a result I'm stuck with my bibliography for the dissertation.

I think it has the do with a special character in the *.bbl file or some kind of clashes between the additional packages and the aaltoseries class, or the requirements of the bst file itself. But I am not sure how to proceed. Could you recommend how to fix this issue?

Thanks,

Pavan

1. Without seeing the actual document and log file of the compilation, I suspect that this clash is caused by the encoding of the *.bbl file. Based on your error description it appears that bibliography style generates a *.bbl file that contains Unicode characters that are not recognized by the compiler that uses an encoding setting other than UTF.

Before I can surely say what is the cause of the problem, I ask you to send be the LaTeX document (or just the document preamble, if you want to maximize your document secrecy), the log file of a compilation attempt, and the generated *.bbl file.

Jussi Pekonen, class developer and maintainer (Department of Signal Processing and Acoustics)

1. Pavan, you would not have had some UTF8 characters in your .bib-file?

'Cause, I got the exact same error message just awhile ago when I added a citation with an author written with a non-latin1 accents to my bib-file. My editor was switched to UTF8 (default for TeXWorks), and hence I erroneously ended up having a UTF8 bib-file. Bibtex (or bibtex8) does not support utf8.

There's no easy work-around that I know. I use escaped accents (check e.g. http://en.wikibooks.org/wiki/LaTeX/Accents) in my bib-file. Ugly, but works.

12. how to add list of publications

%%Forarticledissertations,removeifyouwriteamonographdissertation.
\listofpublications
after this

%% For article dissertations, remove if you write a monograph dissertation.

\listofpublications

13. how to add list of publications

%%Forarticledissertations,removeifyouwriteamonographdissertation.
\listofpublications
after this

%% For article dissertations, remove if you write a monograph dissertation.

\listofpublications

14. How to add preface and a list of abbreviations in the aaltoseries latex template?

15. Preface is just simple unnumbered (starred) chapter after which the preface text is written. The aaltoseries template doesn't take any sides in the debate how the lists of abbreviations, symbols, etc. are typeset. That means that you can do them however you (and most likely your supervisor) want to typeset them.

Jussi Pekonen

16. Should the \addpdfarticle command work if the publication type is set to 'dissertation'? I get an undefined control sequence error.

1. No, the \addpdfarticle command doesn't work in the dissertation mode. That command is for article collections (see pages 16–19 in the documentation).

The command that adds the publication PDFs to a dissertation is \addpublicationpdf.

Jussi Pekonen

1. Okay. Thanks for the clarification.

17. In my article dissertation, I have an article for which the copyright year is 2012, but the nominal year of the journal issue where the article is published is 2013 (this is because the article was available online first). However, there is only one "year" that is used for both when adding a publication.

Is it possible to separately define the article year from the copyright year for the publication information page? I could not find a way to do this.

1. In the current form of the template having a separate years for the copyright and the publication year is not possible. But if you really need that feature, contact me via email and I will give you instructions how to do it.

I will create a possibility to do this in the next version of the template.

Jussi Pekonen

1. I worked around the issue like this:

\addpublication{Authors}{Title}{Journal Name}{other information}{2013}{\hspace*{-3pt}}{2012 Elsevier B.V}{j1}

Here 2013 is in the "month" field, and 2012 with the copyright holder. This messes up the spacing, so I had to add the negative hspace in the "year" field to fix it. Not a very elegant solution, but the result is close enough.

18. Hi

I am writing a thesis compendium in latex using \documentclass[dissertation,nopagenumbers,nochapters]{aaltoseries}. For some reason, my figure numbers still include chapter numbers. I would like to remove them. How can I do that, because this nochapters option doesn't do it for me. But maybe i am inserting it to wrong place?

Thanks.

1. Sry. Figured it out. There is no such option for dissertation mode.

19. Dear Jussi, Dear All,

I am writing my thesis compendium in latex, and I am getting the following warning from one my the papers to be included in my dissertation:

"pdfTeX warning: pdflatex.exe (file C:/Program Files/MiKTeX 2.9/fonts/type1/public/amsfonts/cm/cmr8.pfb): glyph uni0034'

undefined

pdfTeX warning: pdflatex.exe (file C:/Program Files/MiKTeX 2.9/fonts/type1/public/amsfonts/cm/cmr8.pfb): glyph uni003D'

undefined

><C:/Program Files/MiKTeX 2.9/fonts/type1/public/amsfonts/cm/cmsy10.pfb", etc.

I am getting this error only for one of the pdf files (taken from IEEExplore, with all fonts embedded, printout is fine as well), and I could not find any errors or problems with the pdf either. The issue is that all the equations and math symbols in this pdf file vanishes in the dissertation, which makes it difficult to include this paper in the dissertation. I have even updated the MikTex 2.9 'cm' package, with no improvement in the situation.

I was wondering if anyone else has faced the same problem, and is aware of a solution. Googling the problem does not yield any solutions either!

20. I have a question about articles in submitted state in a PhD thesis. Can anyone help or suggest whom I should contact?

I have one article in a submitted state and I mark it as \addpublication[submitted]... When I compile my thesis in draft mode, the "Submitted to" text appears in the thesis for that publication. However, when I compile in final mode, that text does not appear. Why? This shouldn't be the desired behaviour: I asked an academic coordinator and a professor about this and they both stated that the "Submitted to" text definitely should be in the thesis. So, am I doing something wrong with the package or why is the package working like this?

21. Hi,

the instructions of my department say I have to include a doi of of the publications to the info in the list of publications. There seems not to be a convenient way of doing this in the template. Does anyone have viable suggestions?

-Hanne

1. Hello,

I had to add the DOI, since the journal article was available only as the online version. I did the following: \addpublication{Authors}{Title}{Journal}{Online Version, pp. xx--yy, DOI 10.1007/s11235-014-9893-4}{Month}{Year}{Publisher}{jX}

I am not sure if helps, but this seemed acceptable to my supervisor and the committee!

Best Regards.

1. Thank you so much:)

22. Hei,

Miten BibTeX:istä tuodun lähdeluettelon saa kandityön loppuun noudattamaan suomenkielistä meininkiä: siis kirjoittajien listassa "and" sijaan "ja" jne.? Otsikko tulee kyllä suomeksi jo.

Kiitoksia!

Terveisin

Eero

1. Kysymys on vanha, mutta vastaus voi kiinnostaa muitakin. Se vaatii tiedoston *.bst ("BibTeX Style) editointia.

Olen itse editoinut plainnat.bst -> plainnatfi.bst jossa ko. muutokset on tehty: ei vaan 'and' -> 'ja', vain myös 'et al.' -> 'ym.',

'ed.' -> 'toim.', 'Ph.D thesis' -> 'väitöskirja', jne.

Pyydä jos tarvitset. PlainNat on ihan hyvä ja mahdollistaa sekä numerot etta authoryear -viitteet.

23. Hi, I would like to add "submitted to" to a publication. I read this is possible to do only in draft mode, and the problem is that when I am in draft mode I get lots of erros, like Undefined control sequence (list of publications). What do I do wrong? Moreover, is it possible to add a publication as "other", without including the whole paper in the thesis?
Thanks!

24. It is not generally known, but you can set up a PDF file in such a way, that you can jump to a certain location in it from a web page, e.g., like this:

https://users.aalto.fi/~mvermeer/geodesy.pdf#nameddest=chapter.5

which jumps straight to chapter 5.

It requires a bit of preparation of the PDF file. In LaTeX, you must load hyperref with the destlabel option:

\usepackage[destlabel=true, ..., ...]{hyperref}

You must do this at hyperref loading time, not with hypersetup.

--

This facility seems perhaps rather exotic, but it would be very useful in a situation where an integrated teaching environment (which are taking off fast, and which also Aalto folks are playing with) needs to integrate seamlessly with textbook-style materials.

25. I have provisionally taken over maintenance of Aalto-LaTeX, and am now using the new version.aalto.fi gitlab service.

You can find a slightly updated version of the latest aaltoseries.cls (i.e., version 1.2.1) here:

https://version.aalto.fi/gitlab/latex/aaltoseries/tree/master

I haven't yet gotten around to Aalto-Beamer and all the rest of Aalto-LaTEX, but, in due time.

26. Hi Martin,

The top margin of the dissertation body is very narrow. Text looks crammed in the printed dissertations. This makes them strange and unpleasing to read.  The vertical space between header of the page and the first line of the body text needs to be increased significantly.  Is it acceptable to modify the top margin?

P.S. A slight increase in the bottom margin can also improve the look of the pages, but it is not vital. Line spacing of the body text can be decreased to keep the number of the lines same. The lines are spaced wider than normal. I can do the changes and send you an example.

27. Hi Hassan,

yes the whole appearance of the dissertation page format is a bit strange. But I can only do bug fixes and changes that are officially approved... at this point I can create a branch containing your improvements, and find out what the powers that be think of it (in fact, I haven't been able to find who those are )

1. Hi Martin,

Thanks for reply. Branching sounds good. We can put a class file with an example pdf there and ask for review (though one should print it to see the difference). How the procedure works? Do I send a modified class fie to you?

Is there any design guidelines for dissertations? Typically a layout needs to be verbally described and measurements should be provided somewhere.  For example, should the number of lines in a page be exactly 38 or can it be 40?

Best

1. Yes just send me the modified class file (with comments).

I have tried to find such a guideline doc, without success. I did notice that Word and LaTeX dissertations look a bit different, so those guidelines cannot be very strict... I will say that the top margin issue looks the same in both.

1. Hi Martin,

I uploaded modified files to "Development Playground".

Best

28. Committed an update in reponse to Hassan's remarks and using his contribution. Now there is an option 'vertlayout', which enables a better looking vertical layout: top and bottom margins and line spacing.

Also some smaller improvements: a better typewriter font, enabling the 'microtype' package, and more math testing material in the dissertation template.

1. Thanks Martin. Can you put the examples folder into Gits repository? There is only a dissertation example there.

I changed the links above. There is no specific release or release name in the repository. If one clicks on the archive link, the downloaded zip file does not have a nice name! I am not familiar with Git. Is there anyway to change the archive name?

1. OK, where is the examples folder now?

I don't really know git any better than you

29. I've been relatively successful in exporting from LibreOffice (and LibreDraw SVG) through Writer2LaTeX, and am now in Chapter 2 of 9.

The alignment in the list of figures is out, because I have a lot of figures, i.e. 2.10, 2,11, 2.12.  The alignment is off even more because I have long captions, and the wrapped (second) line is position slightly left of where it should be.  (I have long section and subsection titles, too, but the table of contents is better aligned.

Is this something that can be fixed in the template, or do I have to attack a style sheet?  Thanks.

1. Could you attach a screen shot? I think I know what you mean. Have to read up on tocloft...

2. It is much easier to help if you can share your tex files or a minimal working example.

30. oiltb-vol1_front.pdf

Here's a minimal PDF, with the front tables, to show the alignment.

Does this show the issue?  If I have to create a MWE, I'll have to figure out how to embed at least 10 figures into body, so that the count gets up to n.10.

This alignment issue only shows up in the List of Figures, not the List of Tables (as yet) nor the Contents.

1. No this is enough. I recognize the issue. I had redefined the command \numberline of tocloft to get a fixed amount of white after the sectioning numbers (rather than placing them in a fixed-size box as the default does), which is elegant , but breaks the alignment of multi-line sectioning headers. And I have no easy fix for that.

Now I replaced it in git again by the default approach, with the number boxes still broader than the default to accomodate multi-digit numbers. Have a look. Only aaltosection.cls was changed.

BTW for testing multi-digit numbers you can use \setcounter{figure}{10} etc.

1. Martin Vermeer, thanks.  I've downloaded the revised file and can confirm that the List of Figures is now aligned.

31. I'm having problems with wrapfigure not behaving as I would expect.  When I set it to L or l, the figure aligns outside the margin rather than to the paragraph left.  When I set it to R or r, the figure aligns to the paragraph right, but the text is superimposed over top of the figure, rather than flowing around it.

Could this be a problem with something associated with widefloatshift?

I'm attaching (a) manuscript_wrapfig_wanted.pdf , a snippet formatted in LibreOffice and exported to PDF; (b) latex-mwe.pdf as PDF output from TeXstudio; and (c) 20170428_latex-mwe.tar.gz a compressed file with MWE that produced the PDF.

Suggestions are welcomed.

1. I see that you actually use widefloatshift inside a wrapfigure. Frankly I'm not surprised that that doesn't work... one is meant for wide floats, the other for narrow ones

Do you have also problems with wrapfigure on its own?

1. Martin Vermeer, the widefloat in the current document is just where I stopped.  Remove that one line, and the result is the same.

1. OK, then wrapfigure isn't compatible with aaltoseries. Unfortunately I don't know enough about the internals of either to fix this.

I'm afraid wrapfigure is a bit of a kludge, with all kinds of limitations. You will have to look for a workaround I'm afraid.

BTW have you tried floatflt? Who knows it might work

1. Martin Vermeer, Thanks for the suggestion.  It looks as though floatflt works with aaltoseries.  In the MWE,  I now have:

\usepackage[lflt]{floatflt}  % wrapfig incompatible with Aalto template
....
\begin{floatingfigure}[l]{3.2cm} \includegraphics[scale=0.7]{open-private-03_a_data.pdf} \label{figure:methods-data}\end{floatingfigure}

Getting the width right (and scaling) requires trial-and-error to get the right size ... but it works.

32. Hello,

In the dissertation example, the Contents starts on the same page with the Preface. Is this normal behavior?

Thank you.

1. Eh no, that is behaviour introduced by my use of tocloft. You can fix it by inserting \clearpage before it.

I'll fix the white above the Contents header in the repository.

https://tex.stackexchange.com/questions/152628/tocloft-moving-toc-onto-title-page-below-abstract

33. My Ph.D. supervisor "highly recommends" that I should apply APA style in my dissertation. For Chicago author-date, LaTeX is working fine.

If I change from ...

\usepackage[ backend=biber, style=chicago-authordate, sortlocale=en_EN, sorting=nyt, natbib=true, url=true,  doi=true, eprint=false ]{biblatex}

... to ...

\usepackage[ backend=biber, style=apa, sortlocale=en_EN, sorting=nyt, natbib=true, url=true,  doi=true, eprint=false ]{biblatex}\DeclareLanguageMapping{american}{american-apa}

... I get an error (line 266) "Undefined control sequence".

The problem is the same with just the change in style, and if I add the DeclareLanguageMapping , as instructed at http://ctan.mackichan.com/macros/latex/exptl/biblatex-contrib/biblatex-apa/biblatex-apa.pdf , page 3 ...

If you are using babel:\usepackage[american]{babel}\usepackage{csquotes}\usepackage[style=apa]{biblatex}\DeclareLanguageMapping{american}{american-apa}

Here's the MWE: 20170514_latex-mwe-chicago-authordate.tar.gz

Do you have any suggestions? I've seen a similar issue at https://tex.stackexchange.com/questions/80440/using-biblatex-apa and https://tex.stackexchange.com/questions/80440/using-biblatex-apa .

I'm Canadian, and would prefer Canadian spelling, but for the bibiography, either American or British spelling is okay.

1. Unfortunately I am not in a position to help here.... I have myself only use the apalike style for ordinary bibtex, which is not the same thing (much more primitive).

What does the undefined control sequence look like? It is apparently inside the print bibliography command.

It is also probable that this is an issue with the apa style (perhaps interacting with your database) as it works for Chicago. But you knew that already.

1. Martin Vermeer, thanks for the suggestion to look for more detail in the log.  I hadn't actually looked there before.  The error message was:

! Undefined control sequence.<argument> \mkbibdateapalongmdy  {urlyear}{urlmonth}{urlday}\iffieldundef {ur...l.266

This led to a better search, turning up a similar problem at https://tex.stackexchange.com/questions/296476/cant-define-apa-as-bibstyle-undefined-control-sequence-argument-mkbibdatea .

Thus, the resolution is to either be uniform about American or English.  Since I'm using Writer2LaTeX that exports every paragraph with \selectlanguage{english} , the change becomes:

\usepackage[english]{babel}\usepackage{csquotes}\usepackage[style=apa]{biblatex}\DeclareLanguageMapping{english}{english-apa}

The reason that I have moved on to biblatex from bibtex was that the URLs in the reference list were not showing up as active.  Then I read advice that if you're starting anew, it's better to use biblatex.

1. For anyone who is wondering about the difference between the APA 5th and 6th Edition, the major difference appears to be in no longer requiring a retrieval date for online sources.  See http://owll.massey.ac.nz/referencing/apa-5th-vs-6th-edition.php .

A remedy to suppress URL retrieval dates appears at https://tex.stackexchange.com/questions/124568/suppressing-the-retrieval-date-in-biblatex-apa .

2. But why then did it work with Chicago?!

1. Martin Vermeer, somehow the apa style has issues with babel that chicago-authordate does not.  Thus, the DeclarLanguageMapping is required.

The babel package differentiates between english, american, british and canadian.  My guess is that chicago-authordate presumes that english = american ... but I can't be sure.

34. How do I add two appendix chapters at the end of a monograph dissertation?  In LibreOffice, I used Heading 1 without chapter numbers, which made naming the chapters as Appendix 1 and Appendix 2 show up fine after Chapter 9.

I thought I saw an Appendix section somewhere, but am now only finding it in old Finnish documentation.

1. Doesn't the \appendix command work? Aaltoseries is based on report.cls, so this should work. The appendices will be named like this

Appendices

A Title of first appendix

B Title of second appendix

1. Martin Vermeer Thanks, the \appendix command does work.  I couldn't find it in the documentation, but it works when I use it.

35. Are there some resolutions for csquotes?  I've created an MWE, see 20170514_latex-mwe-chicago-authordate.tar.gz , a folder that includes a resulting pdf.

In the MWE, there are two blockquotes.

(1) In the first blockquote, there are two paragraphs.  In the second blockquote, there are three paragraphs.  Instead of having the multiple paragraphs all flowing together, I would expect a newline with vertical space in between those paragraphs, or indenting of the subsequent paragraphs.  The second blockquote doesn't even create a newline.

(2) After the blockquote, I had tried a \noindent in the following paragraph.  This doesn't work.  I have found a workaround with {\setlength{\parindent}{0cm} , but will have to include this after every blockquote.

(3) The vertical whitespace between (a) the preceding paragraph and the blockquote, and (b) the blockquote and subsequent paragraph seems large.  Is there a way to reduce that?

Of the three issues, the first one causes issues with understanding.  The other two, I can work around.  Thanks.

1. While I'm waiting for a response, here's what I've been doing.

(1) In the blockquote, between paragraphs, I've been using:

\hfill \vspace{1mm} \newline

This does work, but the spacing doesn't seem consistent.

(2) The use of ...

{\setlength{\parindent}{0cm}

... isn't working so well.  This turns off all indents, so then it looks like I have to insert an \indent for every paragraph after that.  This is a huge amount of work!

1. Okay, I've got some resolution.

(2) Instead of using \blockquote, I can use \begin{quote}.  In the response to https://tex.stackexchange.com/questions/27498/automatic-noindent-after-quote-environment is the comment:

"[d]on't leave a blank line after \end{quote} (or comment out the blank line)"

Thus, continuing the paragraph (unindented) requires removing the newline, so the \end{quote} doesn't appear on a line by itself.

(1) For multiple paragraphs in blockquotes, I have to use \begin{quote} and not \begin{quotation}.  The difference between the two is described at https://tex.stackexchange.com/questions/33219/whats-the-difference-between-the-environments-quote-and-quotation .

Unfortunately, using \begin{quotation} indents the first line of EVERY paragraph.  The effect that I think should be correct is not have an indent in the first paragraph of the blockquote, and then an indent in subsequent paragraphs.

The absolutely correct syntax would seem to be ...

\begin{quote}
  \blockquote{First paragraph}
  \blockquote{Second paragraph}
\end{quote}

... but this puts an extremely large amount of whitespace between the two paragraphs.

I'm opting for an alternative ...

\begin{quote}
  {First paragraph}
  \hfill \vspace{1mm} \newline
  {Second paragraph}
\end{quote}

... which is uglier in the source code, but reduces the whitespace between paragraphs within the quote.

A superior resolution would be to not have whitespace between paragraphs, and to indent the second paragraph ... but a \noindent after a \begin{quote} doesn't have an effect.

2. Are you sure you gave me the right MWE? I don't see any blockquotes or quotes there. Just blocks of text, enclosed in {} within which the language is selected as english. Don't think you need to do that if you have english in babel. Are you using a special editor doing this automatically?

I also don't find the output PDF in the tarball.

\blockquote is apparently a csquotes package thing. report/aaltoseries have quote, quotation and verse. Do you really want to use csquotes for this? What it gives you is special, localized behavior for the  '  '' symbols. The text blocking behavior is that of the basic \begin{quote} \end{quote}.

I'm sorry to be a bit slow answering... busy with holiday

I'll wait with trying to address your issues until you helped me to understand them better.

1. Martin Vermeer, sorry for the multiple posts.  As I wasn't receiving responses from you, I kept working on the issue.

I've now summarized much of the challenges that I've been having in a latex-mwe_20170707.pdf .  Here is an archive of the directory 20170707_latex-mwe-csquotes.tar.gz that produced that PDF (with the auxiliary files cleared out).

Some other notes:

(a) With directions to create a single volume, I'm now working on appendices instead of the main body of the dissertation.  I can't remember why I included the csquotes package.  I must have used it successfully in the first three chapters, which I will have to go back and completely revise.  There are only a few places where I use quotation marks, and I tend to insert them manually into the body of the text, rather than using a command.  (I may have to rethink that, we'll see).

(b) The selection of english as language is the result of writing (for 10 years!) in LibreOffice and exporting via Writer2LaTeX.  At first I thought it unnecessary, and removed it.  Then, in the first three chapters, I encountered some issues where leaving the english selection in fixed a problem.  Now, as I'm been actively transferring text, the normal paragraphs from LibreOffice have {\selectlanguage{english} , and the blockquote paragraphs have {\selectlanguage{english}\color{black} so that I more easily distinguish between the two.

1. OK I'm beginning to see what makes you unhappy. The official recommendation is to use quotation for multi-paragraph quotations. Then you get indent for all paragraphs including the first. Not what you want?

Also, putting the paragraph after the quotation directly after \end{quotation} is the standard way to have it not indented. I don't think it's fair to call it a trick

Do you also think that the whitespace above/below the quotation is too big?

You may want to look at the 'quoting' package, which allows you to tune all those things. I gave it a quick spin, try

\usepackage[indentfirst=false,vskip=3mm]{quoting}

and use \begin{quoting} ... \end{quoting}

1. Martin Vermeer, thank you very much.

I'm now using ...

\usepackage[indentfirst=false,rightmargin=0pt,vskip=3mm]{quoting}

... as I didn't need the extra whitespace right of the excerpt text.

The quoting package is what I needed!

P.S. It turns out that the csquotes package was required for polyglossia to be handled properly.

36. Hi,

I should include in my Thesis a clarification of subcontracting used in the Thesis, which in my case means three sentences about language check. In my opinion, the most natural place for these three sentences would be on the Author's contributions page, after the contributions listed per publication. Of course, these sentences should form a paragraph of their own, clearly separated from the contributions related to each publication.

However, since these sentences don't relate to any of the publications, they can't be added using the \addcontribution command as there is no preceding \addpublication command. So, is there any other way to input text to the Author's contributions page?

Thanks,

Onerva

1. Apply the following patch to your aaltoseries.cls file (easiest to do manually: find \@starttoc{asc} and put the added lines under there, edit as you see fit):

--- ../aaltoseries.cls  2017-09-19 11:30:22.360597000 +0300

+++ aaltoseries.cls     2017-09-19 11:29:37.403186000 +0300

@@ -1236,6 +1236,10 @@

                        \chapter*{\authorscontributionname}%

                        \addcontentsline{toc}{chapter}{\authorscontributionname}%

                        \@starttoc{asc}%

+                       \section*{Language Check}

+                       \par The author wishes to acknowledge the following:

+                       \par first acknowledgement

+                       \par second acknowledgement

                }%

        }%

        % Label for errata list

Question: Is there any general interest to include a facility for this in Aaltoseries?

1. Thanks, this solved my problem! I don't know how common it is that people need to include this kind of statements in their dissertations. In SCI, according the official rules such statement should be included always if an external language checking service has been used - but I don't know if people i) use language check services and ii) follow the official rules...

1. How does this sound for Swedish?

\def\languagecheckack{%

Språkbruket av min avhandling har granskats av \languagechecker. %

Jag har personligen granskat och accepterat/förkastat resultaterna av språkgransningen ett för ett. %

Detta har inte ändrat vetenskapliga innehållet av min avhandling.%

}%

37. I just uploaded to version an updated aaltoseries.cls, fixing a problem with draftabstract.

You will know that aaltoseries allows you to generate an abstract in three languages, but only in draft mode. It turned out that, for the abstract in the document language – usually English – the font settings for the abstract did not take hold, due to a missing \selectfont command.

--

While doing this, I noticed that in my version of Ubuntu, 16.04LTS, the file finnish.ldf contains a missing percent sign, causing a spurious little indent. Like this

\def\abstractname{Tiivistelm\"a}

edit it to

\def\abstractname{Tiivistelm\"a}%

You need to use sudo on your own computer (and you cannot do it on Aalto's computers )

38. Hi,

The latest dissertation template has a problem with margins. We compiled the dissertation example on different machines and all came out with no margins and text running out of the borders.

Another issue: the links to zip files are broken. I updated the alltoseries link, but aaltologo still has a broken link. The downloaded zip file is empty. We need permanent links to Git master.

39. OK, should be fixed now. The version of dissertation.tex in the repository had the 'abstracts' option set, meant for producing the PDF abstracts to be inserted into the publication platform. Yes, that messes up the margins for the rest of the text. Now removed.

Now also the aaltologo zip file download works – it is generated online from the git repository. The URL for this was wrong (has it changed?)

1. Great. Thank you for the changes.

40. Hi,

the font of the page headers in table of contents, list of figures and list of tables is different from other headers (e.g. List of Publications). In the first case it's a serif font, whereas it is a sans serif for all other chapter headings. This is also the case when I compile the dissertation example given in the .zip above.

Do others have this problem or is this specific to my machine?

Any suggestions how to best change the font?

Thanks,

Anna

1. Insert the following into aaltoseries.cls, around line 378:


Explanation: the package uses the tocloft package, which does its own header definition thing. Hope this helps, thanks for reporting this!

Martin

1. Yes that fixed it.

Thanks for the quick answer!

41. # Package split?

I have noticed that the fact that the class file and related files are in the root of the project, while the example files and what they need, like dissertation.tex, are in the subdirectory 'examples', causes confusion.

After downloading and unzipping the project, the user has either to manually move over the class related files to 'examples', or move dissertation.tex and everything called from it, like the bibliography, image files, included text files... up to root.

Would it be easier to split the package into two, 'aaltoseries' and 'aaltoseries-examples'? Then, people can just download both (and aaltologo) to the same working directory, and start editing. Would this be clearer?

Martin

42. Hi,

I would like to mention that the hyperref package does not work properly. The problem is that the created link does not "jump" to the correct location in the page. For example, in the dissertation example when one click on the "List of Publications" it jumps at the first line of text of the corresponding page, not at the heading, as it should. This happens for all of the \chapter* used in the dissertation. When \chapter is used the jump is at the correct place.

The big problem is when one has also various lists (symbols, abbreviations, tables, figures, etc.) and then the jump is not even on the correct page. This is not a problem for printing, however for the purpose of having links and bookmarks in the pdf this does not work properly.

I was not able to fix it myself, any suggestions are appreciated. Thank you!

Marian

1. I am attaching here the .tex and the pdf files that can be used to reproduce this issue. Class files for aalto are the latest ones.

2. Yep, I see this too with my example file. It is a bug. I think I know how to fix it (and have fixed it in another related project aaltotextbook) but it will take some time to look into. What is your timetable?

Martin

1. Thank you for the reply. I would like to send the file to Unigrafia as soon as possible. Could you instruct me how to fix it or point me to the right direction?

Thanks!

Marian

1. I just committed changes to aaltoseries.cls to git. It should work now for the headers you mentioned. The same problem occurs with the title pages for the included PDFs of publications. Do you have a bundle dissertation? I looked at this hard, but it does not seem easy to fix.

Martin

2. Had another look, and now also the title page header links work correctly. Committed.

I see that still the links for References, Errata and Publications aim a little too low...

Martin

1. Thanks! I downloaded the new version and it works as you mentioned. I also noticed the effect for the References, Errata and Publications, which aim too low.

The problem is that I have two other lists, of abbreviations and of symbols, which still don't work at all. I will send you a bundle over email.

Many thanks for helping out with this issue!

Marian

1. I just pushed a new version 1.2.3 that has abbreviations, symbols, list of figures and list of tables all working correctly with hyperref.

43. # New sub-version published: v1.2.3.

Now it offers commands for a list of abbreviations, a list of symbols, the known lists of figures and tables, but with ToC links and side-panel entries working correctly in hyperref.

44. What should I do if I need to write some Chinese characters in the thesis?

I had find some solutions online but none of them works.

1. I really don't know this, having only switched between English, Finnish and Swedish. I have successfully output Cyrillic names though.

I also tried the things that you probably tried, and no they don't seem to work.

One possibility is brute force: screen cap the Chinese characters as .png files and put them into the file using \includegraphics. That works, I tried it. I hope you don't have a lot of characters

Example of Chinese [\raisebox{-4pt}{\includegraphics[width=2em]{han-chars.png}}]

1. Actually I do not have much Chinese Characters so I think it might work. Thank you

45. Hi,

The text in the Errata page is quite big compared with the rest of the text. Is there a way to use a smaller font size for that particular text?

Thanks!

Oscar

46. Try an environment. \begin{small} ... \end{small}

47. Your suggestion works. Thanks Martin.

48. Hi,

I am looking for the right latex template for article-based doctoral thesis. Can you point towards the file in this package that I can use for that? Thank you!

1. Use dissertation.tex in the examples directory.

49. There seems to be a bug (option conflict) in the aaltoseries.cls template, if you try to use aaltologo.sty. The culprit is line 192.

Commenting the line out seems to fix it, and not have any other effects. That's the workaround until I commit something better.

50. HI,

I am trying to add the package hyperref, but my doctoral thesis does not compile if I add this command. COuld you please suggest how to add hyperref without problems?

51. What error message do you get? What did you try to do? - Martin

1. I tried uncommenting the \usepackage{hyperref} command in the template dissertation.tex. I also tried with several other parameters \usepackage[pdftex]{hyperref} ,\usepackage[pdfpagemode=UseNone,colorlinks=true,urlcolor=red, linkcolor=blue,citecolor=black,pdfstartview=FitH]{hyperref}. A part from that, I tried position it as a last package before begin document, or changing its postion before after algorithm and other packages (i read that the positioning does matter for hyperref).

The error I get is that 'failed to compile'

52. But in the version of the document currently in the repository at version.aalto.fi, this statement, at line 25, is already uncommented, and has been for a long time. The document compiles fine in spite of this.

The error message suggests that you have something in your preamble that is badly wrong. I suggest you make a copy of your .tex file, and replace its preamble with the one found in the dissertation.tex file in the repository. I expect that it will compile fine. After that, you could, step, by step, re-introduce your changes and see which one causes trouble.

HTH Martin

53. Hi,

When compiling the "dissertation" example, the List of Publications has the list numbering alligned left, which effectively indents each publication name by different amounts (please see the picture I've attached). I've seen from other dissertations that the publication names can be alligned on the page (without being "pushed" by the numbers).

I've tried compiling in TeXStudio and Overleaf, both give the same result.

What am I doing wrong? -Maksim

1. Ok, after some trial and error, I found that including \usepackage{enumitem} immediately fixes the problem. Not sure if this is a required package that was missing, or what I had before is the intended behaviour for the dissertation manuscript. Anyway, I'm happy with the result now:

54. I am just finalizing my dissertation with the use of this template and wonder whether it is possible to remove the self-referencing of tableofcontents (i.e., the row "Contents") from the TOC? I have tried several different options from the web, however, without success.

1. This can be fixed by commenting out line NO. 811 from aaltoseries-cls:

%\AaltoSeriesTOCToTOCCommand{chapter}{\contentsname}%