From 1b3da31234d787c28cef3bdee4a239490c710739 Mon Sep 17 00:00:00 2001 From: tomimann <tomi.mannisto@helsinki.fi> Date: Fri, 27 Aug 2021 14:38:08 +0300 Subject: [PATCH] Restructuring, pass on instructions --- HY-CS-main.tex | 91 ++---- HYthesisML.cls | 22 +- bsc_english_contents.tex | 371 --------------------- bsc_finnish_contents.tex | 506 ----------------------------- instructions_english.tex | 115 ------- instructions_finnish.tex | 61 ---- kuvaesimerkki-eps-converted-to.pdf | Bin 7234 -> 0 bytes kuvaesimerkki.pdf | Bin 2582 -> 0 bytes msc_english_contents.tex | 65 ---- msc_finnish_contents.tex | 95 ------ 10 files changed, 42 insertions(+), 1284 deletions(-) delete mode 100644 bsc_english_contents.tex delete mode 100644 bsc_finnish_contents.tex delete mode 100644 instructions_english.tex delete mode 100644 instructions_finnish.tex delete mode 100644 kuvaesimerkki-eps-converted-to.pdf delete mode 100644 kuvaesimerkki.pdf delete mode 100644 msc_english_contents.tex delete mode 100644 msc_finnish_contents.tex diff --git a/HY-CS-main.tex b/HY-CS-main.tex index 04c3644..1eb588d 100644 --- a/HY-CS-main.tex +++ b/HY-CS-main.tex @@ -20,10 +20,11 @@ \documentclass[english,twoside,censored,csm,software-track-2020]{HYthesisML} -% In theses, open new chapters only at right page. -% For other types of documents, may ask "openany" in document. -\PassOptionsToClass{openright,twoside,a4paper}{report} -%\PassOptionsToClass{openany,twoside,a4paper}{report} + +% If wanted, open new chapters only at right page. +% By default, "openany". +%\PassOptionsToClass{openright,twoside,a4paper}{report} +\PassOptionsToClass{openany,twoside,a4paper}{report} \usepackage{csquotes} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -88,17 +89,13 @@ %% Replace parameters with your information. \title{Title} -% TM: Contributors to template editors now listed in the beginning of the file in comments \author{Firstname Lastname} \date{\today} - - % Set supervisors, use the titles according to the thesis language % in English Prof. or Dr., or in Finnish toht. or tri or FT, TkT, Ph.D. or in Swedish... \supervisors{Prof.~D.U.~Mind, Dr.~O.~Why} - \keywords{algorithms, data structures} \additionalinformation{\translate{\track}} @@ -149,45 +146,20 @@ % Generate title page. \maketitle - %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% STEP 3: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%% Write your abstract to be positioned here. +%% Write your abstract in the separate file, to be positioned here. %% You can make several abstract pages (if you want it in different languages), %% in which case you should also define the language of the abstract, %% as below. -% \begin{abstract}{finnish} - -% Tämä dokumentti on tarkoitettu Helsingin yliopiston tietojenkäsittelytieteen osaston opin\-näyt\-teiden ja harjoitustöiden ulkoasun ohjeeksi ja mallipohjaksi. Ohje soveltuu kanditutkielmiin, ohjelmistotuotantoprojekteihin, seminaareihin ja maisterintutkielmiin. Tämän ohjeen lisäksi on seurattava niitä ohjeita, jotka opastavat valitsemaan kuhunkin osioon tieteellisesti kiinnostavaa, syvällisesti pohdittua sisältöä. - - -% Työn aihe luokitellaan -% ACM Computing Classification System (CCS) mukaisesti, -% ks.\ \url{https://dl.acm.org/ccs}. -% Käytä muutamaa termipolkua (1--3), jotka alkavat juuritermistä ja joissa polun tarkentuvat luokat erotetaan toisistaan oikealle osoittavalla nuolella. - -% \end{abstract} - -\begin{otherlanguage}{english} -\begin{abstract} -Write your abstract here. - -In addition, make sure that all the entries in this form are completed. - -Finally, specify 1--3 ACM Computing Classification System (CCS) topics, as per \url{https://dl.acm.org/ccs}. -Each topic is specified with one path, as shown in the example below, and elements of the path separated with an arrow. -Emphasis of each element individually can be indicated -by the use of bold face for high importance or italics for intermediate -level. - -\end{abstract} -\end{otherlanguage} +\include{Ch.00_Abstract} % Place ToC -\newpage +%\newpage \mytableofcontents + \mainmatter %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -196,20 +168,23 @@ level. %% Your actual text starts here. You shouldn't mess with the code above the line except %% to change the parameters. Removing the abstract and ToC commands will mess up stuff. %% -%% You may wish to include material to avoid browsing the definitions -%% above. Command \include{file} includes the file of name file.tex. -%% As a side effect, subsequent inclusions may force a page break. - -% BSc instructions -%\include{bsc_finnish_contents} -%\include{bsc_english_contents} -% MSc instructions -%\include{msc_finnish_contents} -\include{msc_english_contents} +%% Command \include{file} includes the file of name file.tex. +%% A new page will be created at every \include command, +%% which makes it appropriate to use it for large entities such as book chapters. Cannot be nested. +%% It is useful for a big project, as changing one of the include targets +%% won't force the regeneration of the outputs of all the rest. +%% Alternatively, \input is a more lower level macro +%% which simply inputs the content of the given file like it was copy&pasted there manually. + +\include{Ch.10_Introduction} +\include{Ch.20_Methods} +\include{Ch.30_Results} +\include{Ch.40_Discussion} +\include{Ch.50_Conclusions} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\cleardoublepage %fixes the position of bibliography in bookmarks -\phantomsection +%\cleardoublepage %fixes the position of bibliography in bookmarks +%\phantomsection \addcontentsline{toc}{chapter}{\bibname} % This lines adds the bibliography to the ToC \printbibliography @@ -217,17 +192,17 @@ level. \backmatter \begin{appendices} -\appendix{Sample Appendix\label{appendix:sample}} - -You can add one or more appendices to your thesis. - -An appendix starts on its own page, with the name and number of the appendix at the top. -Each appendix is paginated separately. - +%% A sample Appendix +\include{Ch.90_Appendix_1} %% another appendix -\input{instructions_english} +\include{instructions/instructions_english} %% yet another appendix -\input{instructions_finnish} +\include{instructions/instructions_finnish} + +% BSc instructions +%\include{instructions/bsc_finnish_contents} +%\include{instructions/bsc_english_contents} + \end{appendices} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% diff --git a/HYthesisML.cls b/HYthesisML.cls index f4d4f6e..d659b96 100644 --- a/HYthesisML.cls +++ b/HYthesisML.cls @@ -47,13 +47,14 @@ \DeclareOption{alko-line}{\def\track{alko-line}} \DeclareOption{nodes-line}{\def\track{nodes-line}} \DeclareOption{bio-line}{\def\track{bio-line}} -\DeclareOption{sw-line-2017}{\def\track{sw-line-2017}} -\DeclareOption{alko-line-2017}{\def\track{alko-line-2017}} -\DeclareOption{nodes-line-2017}{\def\track{nodes-line-2017}} -\DeclareOption{bio-line-2017}{\def\track{bio-line-2017}} -\DeclareOption{sw-track-2018}{\def\track{sw-track-2018}} -\DeclareOption{alko-track-2018}{\def\track{alko-track-2018}} -\DeclareOption{nodes-track-2018}{\def\track{nodes-track-2018}} +%- should some of these be removed? TM2021 +% \DeclareOption{sw-line-2017}{\def\track{sw-line-2017}} +% \DeclareOption{alko-line-2017}{\def\track{alko-line-2017}} +% \DeclareOption{nodes-line-2017}{\def\track{nodes-line-2017}} +% \DeclareOption{bio-line-2017}{\def\track{bio-line-2017}} +% \DeclareOption{sw-track-2018}{\def\track{sw-track-2018}} +% \DeclareOption{alko-track-2018}{\def\track{alko-track-2018}} +% \DeclareOption{nodes-track-2018}{\def\track{nodes-track-2018}} \DeclareOption{software-track-2020}{\def\track{software-track-2020}} \DeclareOption{algorithms-track-2020}{\def\track{algorithms-track-2020}} \DeclareOption{networking-track-2020}{\def\track{networking-track-2020}} @@ -93,11 +94,6 @@ \if@defaulttypesize \PassOptionsToClass{12pt}{report} \fi -%TM- changed a4page->a4paper \PassOptionsToClass{openright,twoside,a4page}{report} -%TM: Moved to ...main.tex -%\PassOptionsToClass{openright,twoside,a4paper}{report} -% In theses, open new chapters only at right page. -% For other types of documents, may ask "openany" in document. \DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}} % Report class takes care of any errors in options. @@ -270,7 +266,7 @@ %%%% trilanguage handling \RequirePackage{translator} % see the 3 files of translator-UHCSthesis -\usedictionary{translator-UHCSthesis-coverpage-dictionary} +\usedictionary{template/translator-UHCSthesis-coverpage-dictionary} %%%%%% Define commands for filling abstract %%%%% For form texts diff --git a/bsc_english_contents.tex b/bsc_english_contents.tex deleted file mode 100644 index c04482a..0000000 --- a/bsc_english_contents.tex +++ /dev/null @@ -1,371 +0,0 @@ - -\chapter{Introduction} - - -In all writing for publication, the writer's freedom of creation and expression are limited by a number of guidelines and specific regulations. - -At best, a familiar set of regulations shared by reader and writer can create a kind of support network that allows the message to be relayed without distortion. It will be easier for readers to find -the pertinent contents in a piece of writing if its layout and structure are the same as they are used to. This also applies to writers. When writers follow a set presentation model, -they do not have to waste time on considerations that are secondary to the work itself, but they can concentrate on polishing the contents of the text. This means that it is a good -idea to practice following the rules for the layout, though you may think you know how to select a better way to present your work. - -This is a guide for the layout and structure of theses and essays at the Department of Computer Science at the University of Helsinki. It is thus applicable to the course -Scientific Writing, the software engineering projects, seminars, and MSc theses. (This is an updated version of -the previous guide written by the course lecturers \citep{erkio01, erkiomakela96, erkio94, verkamo92}.) - -The \LaTeX\ guide and \LaTeX\ style that has been published on the department's web site can be used as support for this guide. - - -\chapter{Structure} - -Let us start by looking at the sections expected to be in a scientific text. Keep in mind that the same expectations go for all kinds of technical writing. -However, this document in itself, is not a scientific or a research -text, so there will be content lacks in terms of research question -setting in the introduction and evaluative material in the last sections. - -\section{Abstract or summary} -%\enlargethispage{5mm} - - -The summary page contains the following elements: the bibliographical data of the work, an abstract, topic classification, -and the key words. The bibliographical data consists of title, name of the author, place of publication, date of publication, and number of pages. - -The abstract should be short, generally one paragraph (100 words maximum) explaining the main contents of the work: topic, methodology and results. - - - Topics are classified according to the ACM Computing Classification System -(CCS). A small set of paths (1-3) should be used, starting from any top nodes -referred to bu the root term CCS leading to the leaf nodes. The elements -in the path are separated by right arrow, and emphasis of each element individually can be indicated -by the use of bold face for high importance or italics for intermediate -level. The combination of individual boldface terms may give the reader -additional insight. - -\section{Introduction} - - -The purpose of the introduction is to introduce the goals of the work in general terms. Describe topic, -methodology and results (as in the abstract, but expand it). -In order to provide the reader a good starting point for -interpretations, it is good to start the introduction by -contextualisation of the challenges and solutions to be discussed. For -example, why a certain domain has a particular challenge and who are -intended to benefit from the solutions proposed. - -The length of the introduction depends on the length of the whole work. A few pages of text does not need a -separate introduction, since it is an expanded summary in itself. The introduction to a 10-page text can -be 1--1.5 pages long. For a 50--70-page MSc thesis, a 2--4-page introduction seems reasonable. - -The introduction should shortly describe the problem field of the whole work, the plot, and the conclusions, -in general terms. After reading it, the reader may decide whether to go deeper into the topic by reading the whole text. - - -\section{Topic chapters} - -The nature of the matter at hand determines how the topic chapters are disposed. -In order to guide the reader, it is a good idea to start each main chapter with a short paragraph -on what the main topic of the chapter is and how it progresses from one sub-chapter to the -next. Especially relevant is to express how concepts, challenges, -solutions and research steps are bound together. There should be enough -guidance for the reader to allow expectation of the right storyline. - - -Basic rule for easy to follow text is to use the natural emphasis of the -text structure to support the content matter key concepts and thought -processes. This means using openings of sectiosn and text paragraphs for -key arguments and information moves, while the internal parts of -paragraps are filled with supporting aspects that those less familiar -with the topic area need. Those with better background knoweldge can -quickly skim trhough the text without loosing any essential arguments. - -Each author has his or her personal ryhtm in the text, which is visible -for the reader as the length of text paragraphs and complexity of -thought chains within. A good policy is to take only one information -move or transition per paragraph. This way the text stays easy to follow. - -Signs of problems with the disposition of the text are easily seen in texts -with only one sub-chapter, or with more than two chapter levels (main and sub-chapters). There may be justifiable reasons to use three-level -headings in some technical documents. Single sentence text paragraphs -are also to be avoided. - - - -%\pagebreak -\section{Reference usage} - - -Relevant learning targets include superficial knowledge of several -citation styles and capability (and willingness) to follow a given -style and ordering of entires and bibliographical details in the list of references. -These aspects are essential as the approval of a PhD manuscript or -journal article may depend on them. - -Disregard of which style you use, -references are always placed inside sentences. This means that e.g. a separate reference at the end of a paragraph would be inappropriate. - -The structure of the text must clearly show what the reference relates to. At the same time, it -shows how long a piece of the text that the reference relates to. - -Efficient positions for citations are right after the introduction -(definition) of a concept, a methods or such, or in the end of a claim -from the reference material. Furthermore, if quoting verbatime one must -use citation marks. - -The text structures and wordings, in addition to the location of -ciations must clearly express whether claims or arguments are -authors' own, or if they come from the contribution of others. Thus is -is of bad style to open a section by listing the citations on which the -section is based on. Such method can further indicate more serious -problems like following reference material as it is instead of analysing -and synthetising material into new though processes. - - -\section{Conclusion} - -At its simplest, a conclusion is merely a weak revision of the main points of the text. All more valuable -conclusion sections contain comments on e.g. the value of results, how the work relates to its environment, or -future visions. This kind of evaluations should be well-grounded in fact, though, or the conclusion -might inadvertently seem comical. - -\section{Creating the list of references} - -The following guidelines should be followed when creating lists of reference for the -assignments during the course Scientific Writing. - -The guidelines are backed by two main goals: to make it as easy as possible to find the -referenced source, and to show what kind of evaluation process the referenced work has undergone. For these reasons -\begin{itemize} - -\item the reference notes should always be so exact that the source can be recognized and found in catalogues and libraries - -\item different types of sources (monographs, conferences, journals) have to be easy to distinguish from each other, and - -\item the different parts of the list must conform to each other, especially for each source type. -\end{itemize} - - -Independent of the citation style in use, -the sources are listed alphabetically according to the author's name, and works by the same -author (group of authors) in the order in which they have been published. If some publication -does not have an individual writer, it is alphabetized according to its name. - - -The following information should be given on each source independent of -the citation style: -\begin{itemize} -\item -Name(s) of author(s) (surname, initial letters of first names) in the original order; if there are more -than three authors, we can write the name of the first author and {\em et al.} instead of the other names. - -\item -the name of the publication or article in its original form - -\item -place of publication: - -\begin{itemize} - -\item -of monographs: publisher, place of publication (can be omitted if the publisher is well known), year -\item -of journal articles: name of journal, volume, issue, year and month (in parenthesis) - -\item -of articles from article collections (such as conference publications): -\begin{itemize} - -\item name of collection, editor, publisher, place of publication and year - -{\em or} - -\item conference name, coordinator, place and time, - -\end{itemize} - -\item -of a report: series, report number, place, publisher and year - -\item -of a web source: URL, validity date, possibly the date when referenced in square brackets - -\end{itemize} - -\item -page numbers, if the source is an article or constitutes a chapter in a compilation. -\end{itemize} - - -When using web sources, you should keep in mind that the threshold for publication on the web -is non-existent. It is better to concentrate on the publications of well-known scientific -publishers and the technical standards for which the web is the only publication channel. If -the same publication is available on paper, refer to that primarily and add the URL as a complement. - - -The list of references gives an example of a text that has been published through many -channels~\citep{abiteboul,dietinger}and another example that shows a standard that has -been disseminated only through the web~\citep{bray}. For web-based -references it is important to give both the publication date and the -time of reading and interpreting the material. The content is prone to -change, and dating your use, you protect your interpretations for -unnecessary accusations of being faulty, if it is known which version -you used. - - - -The list of references for a text should list exactly the sources that the text refers to. -The list of references for this text is an example of how to present sources, -which is why it contains ''extra'' sources. - - -In any style, -put a full stop after the name of a publication or article, as well as after the bibliographical -data of each reference. Separate the other pieces of information with a comma. As is normal in -Finnish, only the first letter of the first word in the heading is capitalized, but in the titles of -conferences and compilations, each major word is capitalized (not articles or prepositions). See the -appended example for a model. For the sake of clarity, it is best to write {\em In the work} before -the name of a compilation, except in the case of conference publications where the name starts with -the abbreviation {\em Proc.} (for Proceedings). In such cases, no complement is necessary. You can -see the difference by comparing the layouts of the references ~''\citep{dantowsley90}'' and~''\citep{gannonetal89}'' . -In case of other citation styles, it is likely that you can trust the -results given by the automated reference management tools. - -\chapter{Layout} - -This chapter discusses the main issues of the technical presentation of a text. - - -\section{Disposition of text sections} - - -Each text should include a separate cover page, as in this model. The second page contains an -abstract, followed by a table of contents (on one or more pages), and then the main text. -Pagination starts on the first page of the main text (with the Arabic numeral 1). (Rigorous writers -leave out the number from the first page.) All the (numbered) headings and their page numbers should be -written into the table of contents. Many word-processing systems create the table of contents automatically -so that the writer does not have to worry about updating page numbers as the work progresses. If writers -wish to, they can paginate the table of contents and previous pages separately (with Roman numerals), e.g. like this model. - -After the main text, but as part of the text body, comes the list of references; its heading is -not numbered. Any possible appendices are added after the list of references, with headings and internal page numbers. - -%\enlargethispage{5mm} - -If you want to make a coherent list of figures, algorithms and tables, this list should be placed i -mmediately after the table of contents. The value of such lists is a matter of opinion, so there -is no need to create one --- especially if your word-processing software does not support it --- unless your instructor explicitly asks for it. - -If for some special reason you want to add an alphabetical index top your work, it should be placed after -the list of references and before appendices. An index should be noted in the table of contents, as s -hould the list of references (unnumbered chapter). Writers who want to create an index should use the automatic support their word-processing system offes. - -\section{General text layout} - -Nowadays you may plan your text to be printed on single side or double -side, with line spacing one, for the final copy. - -For reviewing and feedback purposes, check with your readers for their -preferences. Most read and comment on paper and need some space for -marking. -For drafts you can use wide margins too. -Both margins should also be fairly broad (ca.~3~cm): the wider left margin is needed for binding the text and the -right one for the instructor's comments. Leave enough space (2--3~cm) at the top and bottom, as well. - -The most effective way to distinguish features like chapters, figures, etc, is to have enough space -in your text. Separate paragraphs from each other with one and chapters with a few empty lines. If a -new chapter is about to start at the bottom of a page (with only one or two lines of text), it is better -to start it on the next page. However, it is not necessary to start every chapter on a new page, especially -not with a short text; if the text contains many pages that are nearly empty, readers might suspect that the -writer has tried to make it look longer than it is. - - -Any empty space may be utilized for displaying figures and tables. Especially if a text is written with the -same type of text throughout, empty lines are necessary for separating e.g.~text from tables. Empty space -is cheap, but adds to the clarity and readability of a text. - -\section{Figures and tables} - -%\enlargethispage{5mm} - -All figures and tables should be placed as near the (first) place in the text that refers to them, but -not before this reference. The text should also explain what the writer wants to illustrate with the -figure. Figures can be interpreted in many different ways, so the reader needs guiding. - -Figures should never be placed immediately under the heading of a chapter, but chapters should always -start with text. Figures should not be placed in the middle of a paragraph (much less a sentence), except -if the figure is placed at the top or bottom of a page and it is clear that the paragraph continues. - -Figures do not always have to be placed immediately after the paragraph that refers to them. If there is -not enough space for a figure on the same page as the paragraph that refers to it, the rest of the page -should not remain empty, Though the figure is inserted on the following page. However, the figure should -never be more than one page away from the reference. - - -The image~\ref{kuvaesimerkki} shows how to present a figure. You must pay attention to the visibility of -figure parts and text, to the numbering of figures, and captions. - -\begin{figure}[ht] -%\begin{figure}[tbh] t= top, b = bottom, h=here -\ \newline -\begin{center} -\includegraphics[width=0.9\textwidth]{kuvaesimerkki.pdf} -%\rotatebox{90}{\includegraphics[scale=.75]{kuvaesimerkki.pdf}} -\caption{Figure elements.} -\label{kuvaesimerkki} -\end{center} -\end{figure} - - -We must also pay attention to the size of figures. Any annotations must be clear and easy to read When -presenting performance curves, for example, the axels have to be named, the scale notated, and the units -clearly presented. If you present many things with similar figures, you should use the same scale for easy comparison. - -The caption of a figure should be written underneath it, and it is preferable that it be short and to -the point than too explicit. The same goes for table captions. - -Figures and tables should be numbered progressively. In long texts, two-level numbering should be -used (e.g. Figure 3.1) according to the chapter number, but in shorter texts, one-level numbering is good enough. - - -You should pay attention to presenting figure and table captions consistently, as well as to punctuation -marks. It is natural to put a full stop after a caption, since they are most often full sentences. - -(The style for figure and table captions vary according to publisher and publication. The recommendations -at the Department of Computer Science also seems to vary with respect to where the caption should be placed.) - - -\section{Headings} - -You can use a different font in headings than in the rest of the text, or underlining, larger fonts, or other -methods of emphasis, but generally it is preferred that you only use one of these methods, because if there are -very many font types and sizes, the layout looks messy. The format of headings must be consistent throughout -the text. You should not use any unnumbered ''extra'' headings. - - -\section{Using this model} - -You can use this text as a model for the layout of your own assignment. The font types and sizes, -line spacing, etc vary according to word-processing system, so small deviations from the rule are acceptable. - -The directive number of pages for written assignments given during the lectures for the Scientific-writing -course and in this guide are applicable to assignments with a layout like this guide's (font size 12 points). The -average line in this text should consist of about 80~characters and one page about 30~lines. The number of pages -includes the text itself and the list of references (the part paginated with Arabic numbers), not the -cover page, summary, or table of contents. - -\chapter{Conclusion} - -This text is a checklist for some of the rules governing written presentations, which you should -keep in mind when writing exercises and theses. - -This collection of advise has been compiled by staff members as the -result of discussions on general good writing habbits in computer -science. The consensus is that all young researchers and academic degree -holders must be able to seek and follow instructions of layout and -structuring of texts depending on the contribution they are working on. -This set of instructions aims at unifying the looks of theses and other -study reports from the department, but it is also a representative of -the instruction sets students will meet later. - -This set of instructions only address the looks of the document. Other -instructions must be sought, read and gained experience with in order to -learn to select the suitable semantical contents for the scientific texts. diff --git a/bsc_finnish_contents.tex b/bsc_finnish_contents.tex deleted file mode 100644 index bda4e36..0000000 --- a/bsc_finnish_contents.tex +++ /dev/null @@ -1,506 +0,0 @@ -\chapter{Johdanto} - - -Kaikessa julkaistavaksi tarkoitetussa tekstissä kirjoittajan luomisen ja -esitystavan vapautta rajoittavat monet ohjeet ja tarkatkin määräykset. - -Parhaimmillaan lukijalle ja kirjoittajalle yhteinen, tuttu säännöstö luo -eräänlaisen tukiverkoston, joka tukee sanoman siirtymistä vääristymättä. -Kirjoituksen lukija löytää kirjoituksesta helpommin olennaisen sisällön, -jos kirjoituksen ulkoasu ja sisällön rakenne vastaavat hänen -tottumuksiaan. Sama koskee myös kirjoittajaa. Noudattaessaan valmista -esitystapamallia kirjoittajan ei tarvitse käyttää aikaansa itse työn -kannalta toissijaisten seikkojen miettimiseen, vaan hän voi keskittyä -hiomaan tekstin sisältöä. Siksi kannattaa harjoitella myös työn ulkoasua -koskevien ohjeiden noudattamista, vaikka omasta mielestään osaisikin -valita esitykselleen ohjetta paremman muodon. - -Tämä kirjoitus on tarkoitettu Helsingin yliopiston -Tietojenkäsittelytieteen osastoon alempien opinnäytteiden ja -harjoitusten ulkoasun ja rakenteen ohjeeksi. Ohje soveltuu siten -kandidaatintutkielman kirjoittamisen kurssille, ohjelmistotuotantoprojekteihin, seminaareihin ja -pro gradu -tutkielmiin. (Kirjoitus on päivitetty uusintapainos aiemmista -ohjeista, jotka kurssin luennoijat ovat laatineet \citep{erkio01,erkiomakela96,erkio94,verkamo92}.) - -Tyylimäärittely on saatavissa pdflatex- ja word-versiona. -Tyylimäärittelyitä valitessa on huomattava ohjeet tekstien syöttöön -liittyvässtä koodauksesta (UTF8,ISO 8859-15). -Tämän kirjoituksen tukena sopivat käytettäväksi tavanomaiset latex- tai -word-oppaat. - -\chapter{Kirjoituksen rakenne} - -Tarkastellaan aluksi tieteelliseltä tekstiltä odotettuja -kirjoituksen osia. Samoihin asioihin on luonnollisesti syytä -kiinnittää huomiota myös muussa teknisessä kirjoittamisessa. Huomattakoon, että tämä teksti ei ole tieteellinen teksti, eikä siten itse sisällä kaikkia niitä elementtejä, jotka tieteellisen tekstin sisällölliseen antiin kuuluvat. Tällaisia puutteita ovat esimerkiksi johdannon tutkimuskysymyksen asettelun puuttuminen sekä arvoivan materiaalin puute tekstin lopussa, sekä yhteenvedon latteus. -Teksti rajoittuu siten otsikkonsa mukaisesti vain tekniseen sisällön asetteluun. - -\section{Tiivistelmä} - - - -Tiivistelmäsivu sisältää seuraavat osat: työn bibliografiset tiedot, -tiivistelmäteksti, aiheluokat ja avainsanat. Bibliografiset tiedot -koostuvat työn otsikosta, tekijän nimestä, julkaisupaikan tiedoista, -julkaisuajankohdasta ja sivumäärästä. - -Tiivistelmäteksti on lyhyt, yleensä yhden kappaleen mittainen -(maksimissaan noin 100 sanaa) selvitys -kirjoituksen tärkeimmästä sisällöstä: mitä on tutkittu, miten on -tutkittu ja mitä tuloksia on saatu. - - -Aiheluokat kuvataan ACM Computing Classification System -luokituksen (CCS) -luokituksen mukaisesti. Luokittelussa käytetään täysia polkuja juurisolmun CCS osoittamista lähtöposteistä lehtisolmuihin. Polkuja voi antaa 1-3 aihepiirien soveltuvuuden mukaan, mitä alempi opinnäyte, sen vähemmän polkuja se tarvitsee. -Poluissa tasot erotetaan toisistaan nuolella eteenpäin. Kun polun nimisanoja arvioidaan suhteessa työn sisältöön, merkitään boldface-fontilla tärkein termi, italics-fontilla toiseksi tärkein. Näin menetellään, mikäli jotkin termeistä ovat olennaisesti paremmin kuvaavia kuin muut polun termit. Nimettyjen polkujen lisäksi lukija voi siten tarkastella lisäulottuvuutena myös tärkeiksi merkittyjen termien joukkoa sinänsä. -Avainsanoiksi valitaan kirjoituksen sisältöä -keskeisesti kuvaavia käsitteitä. - -\section{Johdanto} - - -Johdannon tarkoituksena on kertoa yleiskielisesti -työn tavoite. Kerrotaan (kuten tiivistelmässäkin, mutta laveammin), -mitä on tutkittu, miten on tutkittu ja mitä tuloksia on saatu. -Jotta kysymyksenasettelu ja tulokset on lukijan helppo oikein tulkita on syytä aloittaa johdanto asettelemalla tutkimus asiayhteyteensä, esimerkiksi kertomalla aluksi, minkälaisessa yhteydessä tarkasteluun otettavat haasteet esiintyvät ja keiden on ratkaisuista tarkoitus hyötyä. - -Johdannon pituus määräytyy suhteessa koko kirjoitelman pituuteen. -Parisivuinen kirjoitus ei erikseen otsikoitua johdantoa kaipaa, sillä -se itsessään on laajennettu tiivistelmä. Kymmensivuisen -kirjoituksen johdanto voi olla vaikkapa sivun tai puolentoista -mittainen. Pro gradu -tutkielman 50-70-sivuiseen kokonaisuuteen -tuntuu 2-4-sivuinen johdanto kohtuulliselta. - -Johdanto kertoo siis lyhyessä, yleistajuisessa muodossa -koko kirjoitelman kysymyksenasettelun, juonen sekä tulokset ja johtopäätelmät. -Tämän luettuaan lukija voi päätellä, haluaako syventyä asiaan tarkemmin -lukemalla koko kirjoituksen. - - -\section{Käsittelyluvut} - -Käsittelylukujen työnjako määräytyy käsiteltävän asian luonteen -mukaisesti. -Lukijan ohjailemiseksi kukin pääluku kannattaa aloittaa lyhyellä -kappaleella, joka paljastaa mikä kyseisen luvun keskeisin sisältö on ja -kuinka aliluvuissa asiaa kehitellään eteenpäin. -Erityisesti kannattaa kiinnittää huomiota siihen, että lukijalle ilmaistaan selkeästi miksi kutakin asiaa käsitellään ja miten käsiteltävät asiat suhtautuvat toisiinsa. - -Jäsentelyongelmista kielivät tilanteet, joissa -alilukuja on vain yksi, tai joissa käytetään useampaa kuin -kahta tasoa (pääluku ja sen aliluvut). Kolmitasoisia -otsikointeja saatetaan tarvita joissakin teknisissä -dokumenteissa perustellusti, mutta nämä muodostavat poikkeuksen. - -Perusohjeena on käyttää tekstin rakenteellisesti painokkaita paikkoja, -kuten lukujen avauksia ja teksikappaleiden aloitusvirkkeitä -juonenkuljetukseen ja informaatioaskeleiden sitomiseen toisiinsa. -Tekstikappaleiden keskiosat, samoin kuin lukujen keskiosat selostavat -asiaa vähemmän tuntevalle yksityiskohtia, kun taas aihepiirissä jo -sisällä olevat lukijat voivat alkuvirkkeitä silmäilemällä edetä -tekstissä tehokkaasti eksymättä tarinan juonesta. - -Kullakin kirjoittajalla on oma temponsa, joka välittyy lukijalle -tekstikappaleiden pituudessa ja niihin sisällytettyjen ajatuskulkujen -mutkikkuudessa. Kussakin tekstikappaleessa pitäisi pitäytyä vain yhdessä -informaatioaskelessa tai olennaisessa päättelyaskelessa, muuten juonen -seuraaminen käy raskaaksi olennaisten lauseiden etsiskelyksi. Yksivirkkeisiä -tekstikappaleita on syytä varoa. - - - -\section{Lähdeviittausten käyttö} - - -Olennaisia opittavia asioita viittaustekniikoissa ovat viitteen paikka -tekstissä, oikea lähdeluettelojärjestys valitun viitetyylin parina sekä -taito ja tahto noudattaa annettua tyylimääräystä. Väitöskirjoissa ja -lehti- tai konferenssiartikkeleissa tekstin hyväksyminen riippuu myös -näiden yksityiskohtien asianmukaisesta käsittelystä. Tästä syystä -laitoksella nähdään tarpeelliseksi opiskelijoiden tutustua edes -pinnallisesti myös muihin tyylilajeihin ja oppia käyttämään -automatisoituja muotoilutyökaluja tehokkaasti, jolloin tyylimuutokset -ovat tehokkaita. - -Lähdeviitteet sijoitetaan aina virkkeen sisäpuolelle. Siten esimerkiksi -tekstikappaleen lopussa irrallaan oleva viite ei ole asiallinen. Tilanne -ei muutu, vaikka viite sujautettaisiin tekstikappaleen viimeisen -virkkeen sisään. -Lähdeviittauksen yhteyteen merkitään mukaan tarkentavat -sivunumerot, mikäli lukijan olisi työlästä löytää asianomainen kohta -viitatusta lähteestä. - - -Tehokkaita viitteensijoittelupaikkoja ovat esimerkiksi uuden käsitteen -nimeämiskohta ja virkkeen loppu kun kyseessä on lähteestä lainattu -väite. On myös muistettava lainausmerkkien käyttö silloin kun tehdään -suoria lainauksia. - -Tekstin jäsentelyn on tuotava selkeästi esiin, mihin asiaan viite -liittyy. Samalla tulee ymmärrettäväksi se, kuinka pitkään -tekstikatkelmaan ko. viite liitetään. Ei ole siten asiallista aloittaa -lukua nimeämällä yhtä tai useampaa lähdettä luvun taustaksi, vaan -viitteitä on kiinnitettävä täsmällisemmin väitteisiin ja käsitteisiin. -Luvun avaus viitetiedolla voi olla oire myös suuremmasta ongelmasta: -lähderiippuvuudesta. Aloitteleva kirjoittaja helposti toistaa lähteestä -oppimaansa ilman että tarpeellinen analysointi ja prosessointi suhteessa -muuhun opittuun olisi vielä tapahtut. - -Viitteillä ja sanamuodolilla on -myös tuotava selkeästi esiin se, mikä teksissä on lainattua ja mikä oman -pohdinnan ja valikoinnin tulosta. - - -Lähdeviittauksiin käytetään Tietojenkäsittelytieteen osastolla -numeroitua tyyliä ja APA-tyyliä, valinnan näiden välillä tekevät kunkin -ryhmän valvoja ja ohjaaja yhdessä. -Numeroitu tyyli on esimerkiksi IEEE- ja -ACM-julkaisuissa yleisesti käytetty ja puolustaa siten paikkaansa. -APA-tyyli on poikkeuksellinen ns. kovissa tieteissä, mutta monet -valvojista pitävät siitä sen luettavuuden vuoksi. Numeroita joutuu nimiä -useammin tarkistamaan lähdeluettelosta, sillä tarkastus- ja -arvointiprosessiin kuuluu arvioida myös lähteiden valitaa ja niiden -käyttötapaa. - - - - - -\section{Yhteenveto} - -Yhteenveto vaatimattomimmillaan on vain lyhyt kertaus kirjoituksen -keskeisistä asioista. Arvokkaamman yhteenvedon saa aikaan kommentoimalla - työn tulosten arvoa, työn liittymistä ympäristöön ja -tulevaisuudennäkymiä. Tällaiset arviot huolellisesti -perusteltava. - -\section{Lähdeluettelon laatiminen} - -Tieteellisen kirjoittamisen kurssin töiden lähdeluetteloiden -laatimisessa noudatetaan seuraavia ohjeita. - -Niiden taustalla on kaksi -keskeistä pyrkimystä: tehdä viitatun lähteen hankkiminen luettavaksi -mahdollisimman helpoksi ja ilmaista, millaisen arviointiprosessin -läpi käyneeseen kirjoitukseen vedotaan. -Näistä syistä -\begin{itemize} -\item lähdeviitteen tulee aina olla niin tarkka, että -lähde on sen perusteella tunnistettavissa ja löydettävissä luetteloista -ja kirjastoista, -\item erityyppisten lähteiden (kirjat, konferenssit, lehdet) on erotuttava -toisistaan -ja -\item luettelon eri osien tulee olla mahdollisimman -yhdenmukaisia, erityisesti lähdetyypin sisällä. -\end{itemize} - - -Riippumatta käytettävästä viitetyylistä, -lähteet ovat Tietojenkäsittelytieteen osaston opinnäytteiden lähdeluetteloissa tekijän nimen mukaisessa aakkosjärjestyksessä, -saman tekijän (tekijäryhmän) työt julkaisuajan mukaisessa -järjestyksessä. Jos jollakin lähteellä ei ole henkilötekijää, se -aakkostetaan julkaisun nimen mukaisesti. - -Kustakin lähteestä annetaan seuraavat tiedot, edelleen viitetyylistä riippumatta: -\begin{itemize} -\item (tarvittaessa lähdeviitelyhenne). -\item -tekijän tai tekijöiden nimet (sukunimi, etunimien alkukirjaimet) -alkuperäisessä järjestyksessään; jos tekijöitä on enemmän kuin kolme, -voidaan toimia siten, että -vain ensimmäinen tekijä nimetään ja muiden tilalle kirjoitetaan {\em et -al.} -\item -julkaisun tai artikkelin nimi alkuperäisessä muodossaan -\item -julkaisupaikan tiedot: -\begin{itemize} -\item -kirjasta: kustantaja, julkaisupaikka (voidaan jättää pois, jos kyseessä -on tunnettu kustantaja), vuosi ja -\item -lehtiartikkelista: lehden nimi, volyymi, numero, vuosiluku ja kuukausi (suluissa), - -\item -artikkelikokoelmassa (esim. konferenssijulkaisussa) ilmestyneestä -artikkelista: -\begin{itemize} -\item kokoelman nimi, toimittaja, kustantaja, julkaisupaikka ja vuosi -{\em tai} -\item konferenssin nimi, järjestäjä, paikka ja aika, -\end{itemize} -\item -raportista: julkaisusarja, raportin numero, julkaisupaikka, julkaisija ja vuosi -ja -\item -www-lähteestä: verkko-osoite, voimassaoloajankohta, mahdollisesti -viittausajankohta hakasuluissa -\end{itemize} -\item -sivunumerot, mikäli lähteenä käytetty julkaisu on artikkeli tai kokoomateoksen itsenäinen luku. -\end{itemize} - -Normaaliin suomalaiseen tapaan artikkelin nimessä ainoastaan -ensimmäinen sana kirjoitetaan isolla alkukirjaimella, sen sijaan -konferenssien ja kokoelmajulkaisujen nimissä käytetään isoa -alkukirjainta jokaisen sanan alussa (artikkelisanoja ja prepositioita -lukuunottamatta). Katso mallia oheisista esimerkeistä. -Kokoelman nimen edessä on syytä selvyyden vuoksi käyttää sanaa {\em -Teoksessa}, paitsi kun on kysymys konferenssijulkaisusta, jonka nimi -alkaa lyhenteellä {\em Proc.} (sanasta Proceedings). Tällöin ei tarvita -mitään täydennystä. -Tämän eron näkee esimerkiksi vertaamalla -lähdeviitteiden~''\citep{dantowsley90}'' -ja~''\citep{gannonetal89}'' ulkoasuja. - -WWW-lähteiden käytössä on syytä muistaa, että verkossa julkaisukynnys on -olematon. Kannattaa siten keskittyä tunnettujen tieteellisten -kustantajien julkaisuihin ja niihin teknisiin standardeihin, joille WWW -on ainoa julkaisukanava. Mikäli sama julkaisu on saatavissa myös -perinteisessä muodossa, viitataan ensisijaisesti siihen ja käytetään -verkko-osoitetta lisätietona. Lähdeluettelossa on annettu esimerkit -useita kanavia julkaistusta kirjoituksesta~\citep{abiteboul,dietinger} sekä pelkästään -WWW-julkaisuna -leviävästä standardista~\citep{bray}. - -Erityisesti varoitetaan Wikipedian käytöstä tieteellisessä tekstissä. -Vaikka sen avulla on helppo alustavasti tutustua joihin aihepiireihin ja -asiantuteva lukija voisi teksin kelvolliseksi tiettynä hetkenä -hyväksyäkin, ei se foorumina millään lailla täytä tieteellisesti -vertaisarvoidun tutkimusfoorumin kriteerejä. -Jos Wikipedia-artikkelia ei mitenkään malta ajankuvana olla mainitsematta, käytettäköön jotain muuta kuin lähdeviitetekniikkaa tähän taiteelliseen otteeseen, vaikkapa alaviitteitä. Olennaista silloinkin on, että tieteellinen sisältö ei tule tällä korvatuksi vaan sen puute korostetuksi. - -WWW-lähteeseen viittaamisessa pätevät samat periaatteet kuin -perinteisiin lähteisiin viitattaessa: lähdeviitteessä ilmaistaan -otsakkeet, kirjoittajat, toimittajat js muut seikat. Eroa on ainoastaan -verkko-osoitteen ja sen voimassaoloajankohdan ilmaisemisessa. Mikäli -lähde on julkaistu ainoastaan verkossa, voidaan web-osoitetta (URL) -käyttää vastaavasti kuin perinteisen julkaisun paikannusinformaatiota -(lehden ja se numeron julkaisutiedot). Lähdeluettelossa on WWW-viittausten yhteydessä aina syytä ilmaista päivämäärä, jolloin linkin voimassaolo ja lähteen sisältö on tarkastettu. -Esimerkkeinä verkkoviitteistä soveltuvat seuraavat: -\begin{itemize} -\item Gergen, Kenneth (1999) Narrative, Moral Identity and Historical -Consciousness: a Social Constructionist Account. -http://www.swarthmore.edu/SocSci/kgergen1/text3.html. Haettu 11.6.1999. -\item -Ritala-Koskinen, Aino and Valokivi, Heli (2006) The Role of Development -Skills in Social Work Practice Education in Finland. Social Work and -Society, The International Online-Only Journal 4(2006)1. -http://www.socwork.net/2006/1/series/transition/ritalakoskinenvalokivi. -Viitattu 30.8.2006. -\item Heinisuo, Rami and Ekholm, Kai (1997) Elektronisen viittaamisen -opas. Jyväskylän yliopiston kirjaston julkaisuja n:o 40. Jyväskylä: -Jyväskylän yliopiston kirjasto. http://www.pori.tut.fi/~multisil/evo/. -Viitattu 29.8.2006. -\end{itemize} - -Kirjoituksen lähdeluettelossa luetellaan täsmälleen ne lähteet, joihin -viitataan kirjoituksen tekstiosassa. Tämän kirjoituksen lähdeluettelo on -tarkoitettu lähinnä esitystavan esimerkiksi, mistä syystä siinä on -''ylimääräisiä'' lähteitä. - - -Pääsääntöisesti julkaisun tai artikkelin nimen perään tulee piste, -samoin kunkin lähteen bibliografisten tietojen perään. Muut tiedot -erotetaan toisistaan pilkulla. Useimmissa tapauksissa -voidaan noudattaa teknisten välineiden antamaa mallia, sillä edellytyksellä, että ylläolevat vaatimukset muuten täyttyvät. - - - -\chapter{Ulkoasulliset seikat} - - Tässä luvussa käsitellään yleisimpiä -tekstin tekniseen esittämiseen liittyviä seikkoja. - -\section{Työn osien järjestys} - - Kirjoituksen alussa on aina -erillinen, mallin mukainen kansilehti. Toisena sivuna on -tiivistelmäsivu, sen jälkeen sisällysluettelo (yksi tai useampia -sivuja) ja sitten varsinainen teksti. Sivunumerointi aloitetaan vasta -ensimmäiseltä tekstisivulta (arabialaisella ykkösellä). (Tarkat -jättävät ykkössivun numeromerkittä.) Sisällysluetteloon merkitään -kaikki (numeroidut) otsikot ja vastaavat sivunumerot. Monet -tekstin\-käsittelyjärjestelmät muodostavat itse sisällysluettelon, -jolloin kirjoittajan ei tarvitse huolehtia luettelon sivunumeroiden -päivittämisestä tekstin kehittyessä. Sisällysluettelo\-sivu ja sitä -edeltävät sivut voidaan haluttaessa numeroida erikseen (roomalaisin -numeroin) esimerkiksi tämän mallin mukaisesti. - -Varsinaisen tekstin -jäljessä, mutta itse työhön kuuluvana on ensimmäisenä lähdeluettelo, -jonka otsikkoa ei numeroida. Lähdeluettelon jälkeen sijoitetaan -mahdolliset liitteet, jotka otsikoidaan ja varustetaan sisäisillä -sivunumeroilla. - - - -Mikäli kuvista, algoritmeista -ja taulukoista halutaan tehdä yhtenäinen luettelo, sijoitetaan -luettelot sisällysluettelon jälkeen. Luetteloiden käyttöarvosta on -eriäviä mielipiteitä, joten niiden laatimiseen ei varsinkaan ilman -tekstinkäsittelyjärjestelmän tukea kannata ryhtyä ilman tarkastajan -erityistä toivetta. - -Mikäli kirjoitukseen erityissyistä halutaan -liittää aakkosellinen hakemisto, sijoitetaan se lähdeluettelon jälkeen -ennen liitteitä. Indeksi merkitään sisällysluetteloon samoin kuin -lähdeluettelo (numeroimaton luku). Mikäli indeksin tekemiseen -ryhdytään, on syytä käyttää tekstinkäsittelyjärjestelmän tarjoamaa -automatiikkaa. - -Teksin luonnollisen juonenkuljetuksen mukana esiin -tulevien käsitteiden määrittelyjen sijasta ei pidä yrittää sen enempää -pakata kaikkia määritelmiä johdantoon kuin laatia johdantoa ennen -käsitelistaa tai lyhenteiden selityslistaa. Kumpikaan ei sovi -tavanomaiseen argumentoivaan tieteelliseen tekstityyliin, vaikka -teknisessä yhteydessä niillä liitteinä voi olla lisäarvoa. - - -\section{Tekstin yleinen sijoittelu} - -Lopullinen tutkielmaversio voi olla yksi- tai kaksipuoleiseksi aseteltua -ja riviväliltään 1,5 tai 1. Erityyppisissä -teksteissä haasteet ja asetteluvaatimukset voivat olla erilaiset. Erota -kappaleet toisistaan yhdellä tyhjällä rivillä tai -käytä tekstinkäsittelytyökalujen ominaisuuksia -hyödyksesi ja määrittele tekstikappaleiden väliin jäävä tila hieman -normaalia riviväliä suuremmaksi. - -Kirjoituksen lukujen, kuvien ja taulukoiden erottumisen kannalta -tärkein keino on riittävän tilan käyttö niiden ympärillä. Kuvan ja -nimekkeen tulee olla selkeästi yksi kokonaisuus, joka eroaa muusta -tyhjän tilan rajaamana. Kuvan tai taulukon on aina numerointinsa ja -nimekkeensä kanssa mahduttava yhdelle sivulle tai varmasti -kaksipuolisena paperidokumenttina tarkasteltavassa tekstissä aukeamalle. -Kuvissa fonttikoko ei saa alittaa 8 pistettä. - - - -Jos uusi luku tulisi alkamaan aivan sivun alareunasta (vain yksi tai -kaksi riviä varsinaista tekstiä), aloita mieluummin uusi sivu. Jokaista -uutta lukua ei kuitenkaan ole tarpeen --- etenkään lyhyessä -kirjoituksessa --- aloittaa uudelta sivulta: jos kirjoituksessa on -paljon melkein tyhjiä sivuja, lukija voi epäillä, että kirjoittaja on -yrittänyt saada kirjoituksensa näyttämään pitemmältä kuin se onkaan. - Tyhjää tilaa kannattaa käyttää hyödyksi myös kuvien ja taulukoiden -yhteydessä. Erityisesti jos kirjoituksessa käytetään kauttaaltaan samaa -tekstityyppiä, tyhjät rivit ovat välttämättömiä erottamaan esimerkiksi -tekstiä ja taulukkoa toisistaan. Tyhjä tila on halpaa, mutta se lisää -selkeyttä ja luettavuutta. - - -\section{Kuvat ja taulukot} - - -Kuva tai taulukko sijoitetaan mahdollisimman lähelle -(ensimmäistä) tekstikohtaa, jossa siihen viitataan, ei kuitenkaan -kyseistä viittausta aikaisemmaksi. -Tekstissä on syytä myös kertoa, mitä kuvalla halutaan havainnollistaa. -Kuvan voi lukea monella eri tavalla, joten lukijaa on ohjattava. - -Kuvaa ei pidä sijoittaa välittömästi luvun otsikon alle, vaan on -aloitettava tekstillä. Kuvaa ei pidä sijoittaa keskelle tekstikappaletta -(saati virkettä), paitsi jos kuva tulee sivun alkuun tai loppuun eikä -kappaleen jatkumisesta tule epäselvyyttä. - -Kuvan ei aina tarvitse olla välittömästi viittaavan kappaleen -perässä. Esimerkiksi viittauskohdan ja -vasta seuraavalle sivulle mahtuvan kuvan väliin jäävää sivun loppuosaa -ei jätetä tyhjäksi. Kuvaa ei kuitenkaan pidä viedä seuraavaa -sivua kauemmas viittauskohdasta. - - -Varsinaista kuvan esittämistä havainnollistaa kuva~\ref{kuvaesimerkki}. -Huomiota on kiinnitettävä kuvan osien ja tekstimerkintöjen näkyvyyteen, -kuvan numerointiin ja otsikointiin. - -\begin{figure}[ht] -%\begin{figure}[tbh] t= top, b = bottom, h=here -\ \newline -\begin{center} -\includegraphics[width=0.75\textwidth]{kuvaesimerkki.pdf} -\caption{Kuvan elementit.} -\label{kuvaesimerkki} -\end{center} -\end{figure} - - -Kuvien kokoon on kiinnitettävä huomiota. Käytettyjen merkintöjen -on oltava helposti luettavissa ja selkeät. Esimerkiksi -suorituskykykäyriä esitettäessä akselit on nimettävä, asteikot -merkittävä ja käytetyt yksiköt tuotava selkeästi esiin. -Samankaltaisia asioita esitettäessä useammalla kuvalla on -syytä käyttää samaa mittakaavaa vertailun helpottamiseksi. - -Kuvan otsikko kirjoitetaan kuvan alle ja sen tulee olla mieluummin lyhyt -ja ytimekäs kuin liian selittelevä. -Samoin toimitaan taulukoiden otsikoinnissa. - -Kuvat ja taulukot numeroidaan juoksevasti. Pitkissä teksteissä käytetään -kaksitasoista numerointia (esimerkiksi Kuva 3.1) pääluvuittain, lyhyissä -riittää yksitasoinen numerointi. - - -Kuva- ja taulukko-otsikoiden yhdenmukaiseen esitystyyliin on syytä kiinnittää -huomiota, samoin mm. välimerkkeihin. Luontevaa on käyttää -kuvatekstin lopussa pistettä, ovathan useimmat kuvateksteistä virkkeitä. - -(Kuvien ja taulukoiden otsikointityyli vaihtelee -kustantajittain ja julkaisuittain. Samoin tuntuu suositeltava käytäntö -Tietojenkäsittelytieteen laitoksen sisällä vaihtelevan taulukon -otsikon sijainnin suhteen.) - - -\section{Otsikot} - -Otsikoissa voi käyttää muusta tekstistä poikkeavaa kirjasintyyppiä, -alleviivausta, suurempaa kirjasinkokoa tms.\ erotuskeinoa, yleensä -kuitenkin vain yhtä näistä, koska kovin monta erilaista kirjasintyyppiä -ja -kokoa tekee ulkoasusta helposti sekavan. Otsikoiden esitystavan on -oltava johdonmukainen läpi koko kirjoituksen. Numeroimattomia -''ylimääräisiä'' otsikoita ei tule yleensä käyttää. - - -\section{Mallin käyttö} - -Voit käyttää tätä kirjoitusta mallina oman opinnäytteesi ulkoasua -varten. Eri tekstinkäsittelyjärjestelmissä käytössä olevat yksityiskohdat kuten -kirjasintyypit ja -koot ja rivivälit poikkeavat toisistaan, joten -pienet poikkeamat ovat toki hyväksyttäviä. - -Tieteellisen kirjoittamisen kurssin luennoilla ja -liitteenä olevassa ohjeessa annetut töiden ohjeelliset sivumäärät -koskevat työtä, joka vastaa ulkoasultaan tätä ohjetta (kirjasinkoko -12~pistettä). Tässä tekstissä keskimääräinen rivin pituus lienee noin -80~merkkiä ja sivun pituus 35-40~riviä. -Sivumääriin lasketaan varsinaisen tekstiosuuden pituus ja lähdeluettelo -(arabialaisin numeroin numeroitu osuus), ei kansilehteä, tiivistelmää -eikä sisällysluetteloa. Sivumääräarviossa otetaan huomioon hyvin vajaat -sivut, joita syntyy paljon lyhyiden lukujen ja taittotyyliin määritellyn -luvun avauksen pakottaminen oikeanpuolimmaiselle sivulle. - -\chapter{Yhteenveto} - -Tämän kirjoituksen tarkoituksena on toimia muistilistana eräistä -esitystavallisista säännöistä, joihin harjoitusten ja tutkielmien -kohdalla on syytä kiinnittää huomiota. - -Annetut ohjeet on laitoksen henkilökunta muotoillut yhdessä keskustellen -ja noudattaen oman tieteenalansa perinteitä. Eri erikoistumisaloilla ja -erilaisillaa määräävässä asemassa olevissa julkaisufooruilla käytänteet -vaihtelevat ja nuorten tutkijoiden onkin tiedostettava ero yleisten -sisältöohjeiden ja teknisten muotoilusääntöjen välillä. Aina tekstin -valmistuessa on tarkastettava erikseen, täyttääkö se annetut -pituusrajoitteet ja vastaako se annettuja muotoiluohjeita, olivatpa ne -kuinka pikkutarkkoja tahansa. Tarkasta sääntöjen noudattamisesta syntyy -yhteinäisyyttä kokoovan julkaisun tasolla, mikä helpottaa lukijoiden -työskentelyä. - -Tämä ohje vastaa vain asettelullisiin kysymyksiin ja sen rinnalla on -syytä tutustua materiaaliin ja luentoihin, joissa keskitytään tekstin -varsinaiseen sisältöön. Olennaisin väline on kuitenkin akateemisesti -pidemmälle ehtineen, jo julkaisuja rakentaneen ohjaajan palaute ja -mentorointi. - diff --git a/instructions_english.tex b/instructions_english.tex deleted file mode 100644 index 190357c..0000000 --- a/instructions_english.tex +++ /dev/null @@ -1,115 +0,0 @@ - -\appendix{Instructions for LaTex} - -\section{General Setup} - -In the HY-CS-main.tex file you will find the following STEPS 0--5. Below you can find related instructions. -\vspace{0.5cm} - -\textbf{STEP 0 -- Access the thesis template} - -\begin{itemize} -\item Import the thesis template into a new Overleaf project. -\item The easiest way to do it is to: -\begin{itemize} - \item Obtain a zip file of the LaTeX template from the webpage of your programme. - \item Go to \url{https://www.overleaf.com/edu/helsinki} and login to Overleaf with your university credentials. - \item Go to the list of your projects at \url{https://www.overleaf.com/project}, click ``New Project'' and ``Upload Project''., the projects under your account - \item Then upload the zip with the template. - \item You are now ready to write your thesis in Overleaf by editing the template. -\end{itemize} -\end{itemize} - - -{\textbf{STEP 1 -- BSc or MSc thesis?}} -\begin{enumerate} -\item Select whether your are writing BSc (tkt) or MSc (csm for CS, dsm for data science) thesis. -\item Select your language: finnish, english, or swedish. -\item If you are writing MSc select your line / track. -\end{enumerate} - - -{\textbf{STEP 2 -- Set up your personal information}} - -\begin{enumerate} -\item Specify the title of your thesis with \texttt{\textbackslash title\{\}}. -\item Specify your name to the author field with \texttt{\textbackslash author\{\}}. -\item Specify the names of your supervisors of the thesis with \texttt{\textbackslash supervisors\{\}}. -\item Specify the keywords of the thesis with \texttt{\textbackslash keywords\{\}}. -\item Specify the ACM classification terms of the thesis with \texttt{\textbackslash classification\{\}}. See \url{https://dl.acm.org/ccs} for more information. -\end{enumerate} - -{\textbf{STEP 3 -- Write your abstract}} - -\begin{itemize} -\item You can have the abstract in multiple languages with the \texttt{otherlanguages} environment. The example below shows how to provide an english abstract: - -\begin{verbatim} -\begin{otherlanguage}{english} -\begin{abstract} -Your abstract text goes here. -\end{abstract} -\end{otherlanguage} -\end{verbatim} - -\end{itemize} - -{\textbf{STEP 4 -- Writing your thesis}} - -\begin{enumerate} -\item There are some minimal contents and instructions in the [bsc/msc]\_[finnish/english]\_contents.tex files. -\item You can delete the contents of the [bsc/msc]\_[finnish/english]\_contents.tex file and write your thesis inside that file. -\item Remove this appendix from your thesis. -\end{enumerate} - -{\textbf{STEP 5 -- Set your bibliography style}} - -\begin{itemize} -\item The default is Numbering alphabetic order, which should be used in most cases. -\end{itemize} - -\section{Bibliography in Latex} - -The bibliography is defined in a separate .bib-file. For this template, it is named \texttt{bibliography.bib} and includes the following content: -\begin{verbatim} -@article{einstein, - author = "Albert Einstein", - title = "{Zur Elektrodynamik bewegter K{\"o}rper}. ({German}) - [{On} the electrodynamics of moving bodies]", - journal = "Annalen der Physik", - volume = "322", - number = "10", - pages = "891--921", - year = "1905", - DOI = "http://dx.doi.org/10.1002/andp.19053221004" -} - -@book{latexcompanion, - author = "Michel Goossens and Frank Mittelbach and Alexander Samarin", - title = "The \LaTeX\ Companion", - year = "1993", - publisher = "Addison-Wesley", - address = "Reading, Massachusetts" -} - -@misc{knuthwebsite, - author = "Donald Knuth", - title = "Knuth: Computers and Typesetting", - url = "http://www-cs-faculty.stanford.edu/%7Eknuth/abcde.html" -} -\end{verbatim} - -In the last reference url field the code \verb+%7E+ will translate into \verb+~+ once clicked in the final pdf. - -References are created using command \texttt{\textbackslash cite\{einstein\}}, showing as \citep{einstein}. Other examples: \citep{latexcompanion,knuthwebsite}. - -For the style of bibliography and citations, see some options in \url{https://www.overleaf.com/learn/latex/Bibtex_bibliography_styles}. - - -\section{Producing the thesis pdf} - -This template has been prepared in LaTeX for usage with Overleaf. If your LaTeX source files contain no errors, then Overleaf produces the pdf file automatically. - -You are allowed to use the LaTeX template and write your thesis in other systems, but make sure you know how to produce the pdf file there. -For example, in Linux, you typically need to execute the commands \texttt{pdflatex mainfile.tex} and \texttt{biber mainfile.tex} repeatedly until no more warnings are shown. This process can be automised using make-command. -Note that normally we would be using \texttt{bibtex} command instead of \texttt{biber} but because of the biblatex package \texttt{biber} should be used. diff --git a/instructions_finnish.tex b/instructions_finnish.tex deleted file mode 100644 index b3b5774..0000000 --- a/instructions_finnish.tex +++ /dev/null @@ -1,61 +0,0 @@ - -\appendix{Tutkielmapohjan käyttöohjeet} - - -HY-CS-main.tex tiedosto sisältää viisi askelta STEPS 0--5. Alla on kuvattu, mitä nämä askeleet tarkoittavat ja miten niitä seuraamalla luot itsellesi oikeanlaisen tutkielmapohjan. -\vspace{0.5cm} - -\textbf{STEP 0 -- Kopioi itsellesi tutkielmapohja} - -\begin{itemize} -\item Tämä sama pohja on käytössä kaikille tutkielmatyypeille:\\ \url{https://www.overleaf.com/read/hzgngkgshqwh} -\end{itemize} - - -{\textbf{STEP 1 -- BSc vai MSc tutkielma?}} -\begin{enumerate} -\item Valitse (tiedostossa HY-CS-main.tex) oletko tekemässä BSc (tkt uusi tutkinto, tktl vanhatutkinto) vai MSc (csm tutkinto/30~op) -%, dsm datatiede) -tutkielman. -\item Valitse kieli jolla kirjoitat tutkielman: finnish, english, tai swedish. -\item Jos olet kirjoittamassa MSc tutkielmaa, valitse linja/opintosuunta. -\end{enumerate} - - -{\textbf{STEP 2 -- Aseta henkilökohtaiset tietosi}} - -\begin{enumerate} -\item Kirjoita alustava otsikko tutkielmallesi. -\item Kirjoita oma nimesi. -\item Kirjoita ohjaajien ja tarkastajien nimet (mikäli tiedossa). -\end{enumerate} - -{\textbf{STEP 3 -- Kirjoita tiivistelmä(t)}} - -\begin{itemize} -\item Voit kirjoittaa tiivistelmän (koko tiivistelmäsivu) eri kielillä \texttt{otherlanguages}-ympäristön avulla. Alla esimerkki jolla kirjoitat englanninkielisen tiivistelmän muulla kuin englannin kielellä kirjoitettuun tutkielmaan: - -\begin{verbatim} -\begin{otherlanguage}{english} -\begin{abstract} -Your abstract text goes here. -\end{abstract} -\end{otherlanguage} -\end{verbatim} - -\end{itemize} - -{\textbf{STEP 4 -- Kirjoita tutkielma}} - -\begin{enumerate} -\item Tutkielman kirjoittamista varten löydät ohjeita tiedostosta \newline \texttt{[bsc/msc]\_[finnish/english]\_contents.tex}. -\item Kun olet tutustunut ohjeisiin, voit poistaa tiedoston \newline \texttt{[bsc/msc]\_[finnish/english]\_contents.tex} sisällön ja kirjoittaa oman tutkielmasi kyseiseen tiedostoon. -\end{enumerate} - -{\textbf{STEP 5 -- Aseta kirjallisuuslähdeluettelon tyyli}} - -\begin{itemize} -\item Oletustyyli tekijä-vuosi, eli (Einstein, 1905), voit vaihtaa tyylin (tiedostossa HY-CS-main.tex) helposti kommentointia muuttamalla numeroituun, eli [1], tai aakkostyyliin, eli [Ein05]. -Lisää ohjeita liittyen viittaustyylin säätämiseen {Bib}\TeX issä löytyy verkosta: \url{https://ctan.org/pkg/biblatex} - -\end{itemize} diff --git a/kuvaesimerkki-eps-converted-to.pdf b/kuvaesimerkki-eps-converted-to.pdf deleted file mode 100644 index fda3409c625708ba9267e2e1e5b575cb4d9518ca..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7234 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 diff --git a/kuvaesimerkki.pdf b/kuvaesimerkki.pdf deleted file mode 100644 index 1f93d098c1283494215fcfe7007fc973dec46c46..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2582 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 diff --git a/msc_english_contents.tex b/msc_english_contents.tex deleted file mode 100644 index fd994f3..0000000 --- a/msc_english_contents.tex +++ /dev/null @@ -1,65 +0,0 @@ -\chapter{Introduction} - -The following gives some superficial instructions for using this template for a Master's thesis. For guidelines on thesis writing you can consult various sources, such as university courses on scientific writing or your supervisors. - -The thesis should have an introduction chapter. Other chapters can be named according to the topic. In the end, a concluding chapter is needed; see Chapter~\ref{chapter:conclusions} for an example. - -\chapter{Figures and Tables} - -Besides text, you can use figures and tables in your thesis. - -\section{Figures} -Figure~\ref{fig:logo} gives an example how to add figures to the document. -% -Using figures is particularly useful to display plots of experimental results. - -Remember always to cite the figure in the main text. In addition, consider providing the figure with a descriptive caption. - -\begin{figure}[h!] -\begin{center} -\includegraphics[width=0.3\textwidth]{template/figures/HY-logo-ml.png} -\caption{University of Helsinki flame-logo for Faculty of Science.\label{fig:logo}} -\end{center} -\end{figure} - -\section{Tables} - -Table~\ref{table:results} gives an example of a table that reports experimental results. - -Remember always to cite the table in the main text. - -\begin{table}[t!] -\begin{center} -\caption{Experimental results.\label{table:results}} -\begin{tabular}{l||l c r} -Experiment & 1 & 2 & 3 \\ -\hline \hline -$A$ & 2.5 & 4.7 & -11 \\ -$B$ & 8.0 & -3.7 & 12.6 \\ -$A+B$ & 10.5 & 1.0 & 1.6 \\ -\hline -% -\end{tabular} -\end{center} -\end{table} - -\chapter{References} - -It is very likely that, at various points in your thesis, you will need refer to other parts of the thesis or even to other works from the literature. -% -Referring to other parts of the thesis is usually straightforward --- e.g., ``see -Appendix~\ref{appendix:sample} for some additional material'' or ``see Figure~\ref{fig:logo} on page~\pageref{fig:logo}''. - -To refer to other works in the literature, make sure you include a ``Bibliography'' chapter after the concluding chapter that lists all the works that you refer to in your text; and that you refer to the works in the bibliography using an appropriate \emph{citation key}. -% -This thesis template contains an example of a bibliography. -% -As an example of a citation key, we can write \citep{einstein} to refer to the work written by Einstein in 1905, as it appears in the bilbliography included in this template. - -Note that there are different possible styles for the bibliography and citation keys. -% -You may consult your supervisors on the chosen style -- and once you arrive at a preferred style, use it consistently throughout the thesis. - -\chapter{Conclusions\label{chapter:conclusions}} - -It is good to conclude with a summary of findings. You can also use separate chapter for discussion and future work. These details you can negotiate with your supervisor. diff --git a/msc_finnish_contents.tex b/msc_finnish_contents.tex deleted file mode 100644 index 570be95..0000000 --- a/msc_finnish_contents.tex +++ /dev/null @@ -1,95 +0,0 @@ -\chapter{Johdanto} - -Seuraavassa on joitain ohjeita tämän tutkielmapohjan käyttöön maisterintutkielmassa. Kirjoittamisohjeita löytyy useasta eri lähteestä. Voit esimerkiksi tutustua kandidaatintutkielman ohjeisiin. -Ohjaajan kanssa on hyvä keskustella aikaisessa vaiheessa työn rakenteesta. - -\chapter{Kuvat ja Taulukot} - -\section{Kuvat} -Kuva~\ref{fig:logo} toimii esimerkkinä kuvan lisäämisestä työhön. Muista myös viitata jokaiseen kuvaan tekstissä. - -\begin{figure}[h!] % remove [h!] for automatic placement, which is probalby better for a thesis with more text on page -\centering -\includegraphics[width=0.3\textwidth]{template/figures/HY-logo-ml.png} -\caption{Helsingin yliopiston logo matemaattis-luonnontieteellisen tiedekunnan värein.\label{fig:logo}} -\end{figure} - -\section{Taulukot} - -Taulukossa~\ref{table:results} on esimerkki kokeellisten tulosten raportoinnista taulukkona. Muista myös viitata jokaiseen taulukkoon tekstissä. - -\begin{table}[h!] -\centering -\caption{Kokeelliset tulokset.\label{table:results}} -\begin{tabular}{l||l c r} -Koe & 1 & 2 & 3 \\ -\hline \hline -$A$ & 2.5 & 4.7 & -11 \\ -$B$ & 8.0 & -3.7 & 12.6 \\ -$A+B$ & 10.5 & 1.0 & 1.6 \\ -\hline -% -\end{tabular} -\end{table} - -\chapter{Viitteet} - -\section{Kirjallisuusviitteet} - -Kirjallisuuslähteet ylläpidetään erillisessä .bib-tiedostossa. Tässä tutkielmapohjassa käytetyt kirjallisuuslähteet, joista esimerkkejä kuvassa~\ref{bibexamples}, löytyvät tiedostosta\newline \texttt{bibliography.bib}. - -\begin{figure}[h!] - \centering - \begin{scriptsize} - -\begin{verbatim} - -@article{einstein, - author = "Albert Einstein", - title = "{Zur Elektrodynamik bewegter K{\"o}rper}. ({German}) - [{On} the electrodynamics of moving bodies]", - journal = "Annalen der Physik", - volume = "322", - number = "10", - pages = "891--921", - year = "1905", - DOI = "http://dx.doi.org/10.1002/andp.19053221004" -} -@book{latexcompanion, - author = "Michel Goossens and Frank Mittelbach and Alexander Samarin", - title = "The \LaTeX\ Companion", - year = "1993", - publisher = "Addison-Wesley", - address = "Reading, Massachusetts" -} -@book{knuth99, - author = "Donald E. Knuth", - title = "Digital Typography", - year = "1999", - publisher = "The Center for the Study of Language and Information", - series = "CLSI Lecture Notes (78)" -} -\end{verbatim} -\end{scriptsize} - \caption{Esimerkkejä kirjallisuuslähteiden kuvaamisesta .bib-tiedostossa.} - \label{bibexamples} -\end{figure} - -Viitteet kirjallisuuslähteisiin muodostetaan komennolla \texttt{\textbackslash citep\{einstein\}}, josta generoituu tekstiin valitun viittaustyylin mukaisesti muotoiltu viite \citep{einstein}, tai \texttt{\textbackslash citep\{latexcompanion,knuth99\}}, josta tekstiin puolestaan generoituu \citep{latexcompanion,knuth99}. Tekstissä viitatut kirjallisuuslähteet tulevat automaattisesti viiteluetteloon. Kirjallisuuslähteiden tietojen oikeellisuus ja yhdenmukaisuus .bib-tiedostossa vaikuttavat luonnollisesti siihen, miten tiedot tutkielmassa näyttäytyvät. Tämä on syytä huomioida, sillä esim. verkosta valmiiksi {Bib\TeX} muodossa löytyvien tietojen täydellisyyten tai samanmuotoisuuteen ei pidä sokeasti luottaa. - -Keskustele viittaustyylin valinnasta ohjaajan kanssa. Joitain vaihtoehtoja on osoitteessa:\\ -\url{https://www.overleaf.com/learn/latex/Biblatex_bibliography_styles}. -%\url{https://www.sharelatex.com/learn/Bibtex_bibliography_styles}. - -\section{Ristiviitteet} - -%Liite~\ref{appendix:model} sivulla~\pageref{appendix:model} sisältää lisämateriaalia. -Taulukossa~\ref{table:results} sivulla~\pageref{table:results} on koottuna kokeelliset tulokset. - -% \chapter{Pdf:n luominen tex:stä} - -% Linuxissa voit ajaa komentoja \texttt{pdflatex filename.tex} ja \texttt{biber filename.tex} vuorotelleen kunnes ohjelmat eivät enää anna varoituksia. Prosessi on helppo automatisoida make-komennon avulla. - -% \chapter{Johtopäätökset\label{chapter:conclusions}} - -% Tutkielma on hyvä päättää johtopäätöksiin tutkielman löydöksistä. -- GitLab