kks32 / phd-thesis-template

A LaTeX / XeLaTeX / LuaLaTeX PhD thesis template for Cambridge University Engineering Department (CUED)
http://www-h.eng.cam.ac.uk/help/tpl/textprocessing/ThesisStyle/
MIT License
828 stars 400 forks source link

Annexes after appendix #99

Open deOliveira-R opened 8 years ago

deOliveira-R commented 8 years ago

Please, add support for Annexes after Appendix. It's slightly different than appendix in that it was not made by the author. It would be convenient in cases such as a table that is too big to be put in the main body and breaks the flow of reading.

In my case, I have a table from IAEA that takes the whole page. It is too hidden in the Internet to just assume it would be found and not as usual as the periodic table of elements to assume it could be on the reader's wall (even if they are nuclear engineers).

johannesbottcher commented 8 years ago

I am not sure i understand, \appendix is defined for exactly that purpose.

deOliveira-R commented 8 years ago

From what I saw, It does another job, but please correct me if I’m wrong.

When I use the appendix, I define \section{appendix title} and then the TOC automatically gets APPENDIX A

I don’t have control on how its going to appear in the TOC, it simply appears as APPENDIX A (or B, whatever).

Now that is fine for content you generate yourself. If I did a big table and I don’t want to put into the text or I’m going into great detail in something that is not necessarily important in the main body. I put that in the appendix. As far as I’m aware, appendix is for author’s generated content.

Annexes on the other hand, as far as I know, is for content which was not made by the author but was annexed into the document to make the job of the readers easier in something that could be tricky. For example, my topic is nuclear and I want to include a table that can be found inside the database of the International Atomic Energy Agency website. It occupies a whole page, it disturbs the flow of the text and it might be optional for some readers, so I don’t want to put into the main body. But for readers that never saw this table it would increase their understanding. However, it is not contend done by the author, so it should not into the appendix section, but into the annex section.

Basically I’m proposing including a method where after all the appendix where someone can write something like \include{annex1\annex1} in thesis.tex, and in the annex1.tex I write \section{annex title} and the TOC gets a heading ANNEX A .

I think this would be a good addition if possible. I like to make the job of my readers easier by including 1 or 2 annexes where they can check info if they are interested without having to go all the way to a fairly hidden references.

johannesbottcher commented 8 years ago

Large parts of your report is based on stuff you learned, you are citing stuff, you give references. You should do so for every picture/graphic you did not make yourself.

Adding a table, as long as you have right to put it in your thesis (copyright), is fine, but give the proper citation/source for the material.

You can do \chapter{Additional Material} and fill it up with useful stuff. If you don't want it numbered, use the starred form (\chapter*{Add Material}). If you are worried about authorship, how about a footnote at a relevant point: \footnote{For more detail, please visit \url{ActualUrl}}.

The real important part, no matter if you call it Appendix, Annex or Wombat, is: "Ok, that is not mine, i took that from somewhere, here is a proper reference to the original."

PS: Your thesis office may have another opinion on that.

deOliveira-R commented 8 years ago

I’m not worried about authorship neither about lack of citation. I presume anyone that actually got to this point and is going to the length of using LaTeX knows how to cite and what can be included in the report and the best way to do it.

You seem to be worried about things which are simply besides the point. Anyone would have to do it using LaTeX or MS Word.

My point is about styling, which is the actual purpose of LaTeX.

I believe an entry called ANNEX A just as it happened with APPENDIX A would give the report additional facilities around styling, such as the one I mentioned.

Em 23 de ago de 2016, à(s) 20:45, Johannes Böttcher notifications@github.com escreveu:

Large parts of your report is based on stuff you learned, you are citing stuff, you give references. You should do so for every picture/graphic you did not make yourself.

Adding a table, as long as you have right to put it in your thesis (copyright), is fine, but give the proper citation/source for the material.

You can do \chapter{Additional Material} and fill it up with useful stuff. If you don't want it numbered, use the starred form (\chapter*{Add Material}). If you are worried about authorship, how about a footnote at a relevant point: \footnote{For more detail, please visit \url{ActualUrl}}.

The real important part, no matter if you call it Appendix, Annex or Wombat, is: "Ok, that is not mine, i took that from somewhere, here is a proper reference to the original."

PS: Your thesis office may have another opinion on that.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/kks32/phd-thesis-template/issues/99#issuecomment-241853311, or mute the thread https://github.com/notifications/unsubscribe-auth/AQ8-4ETh_qWEuoGUjr1-rJqaqjsv9lLlks5qi03BgaJpZM4JkBid.

johannesbottcher commented 8 years ago

Ah, ok. The template author has to decide on that matter. :-)