Initial commit

Konvertering af Notebook til PDF.ipynb

+/home/jakle/Python/pilot-project-for-01005/Konvertering af Notebook til PDF.ipynb
\ No newline at end of file

Ofte sete problemer ved konvertering til PDF.ipynb

+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Af Christian Mikkelstrup, s194345\n",
+    "\n",
+    "Hvis du stadig har problemer efter at have fulgt *Konverting af Notebook til PDF* (ligger på DTU Learn), har jeg fundet følgende ting, som I kan prøve/checke virker!\n",
+    "\n",
+    "# Genstart VS Code\n",
+    "\n",
+    "Ja, den kedelige genstart... Jeg ved det godt, men det virker altså flere gange end man faktisk skulle tro! Det er dog vigtigt, at du helt lukker for alle instancer af programmet (på Mac betyder dette både det røde kryds, men også at finde den i linjen i bunden og sige \"quit\"). Når du starter den op igen, er der lidt større chance for, at det virker nu! \n",
+    "\n",
+    "Hvis ikke dette virker, så prøv heldet med følgende punkter, og slut af med en genstart igen!\n",
+    "\n",
+    "# Check at alt er installeret korrekt!\n",
+    "\n",
+    "## Pandoc\n",
+    "\n",
+    "Du kan tjekke om du har installeret Pandoc korrekt ved at åbne en terminal og køre kommandoen \"pandoc\". Hvis beskeden du får ud er *alt andet end* \"det ved jeg ikke betyder\", som i billedet nedenfor, så burde det være installeret korrekt! Et eksempel på hvad der så kan stå, hvis det virker, er nedenfor\n",
+    "\n",
+    "![PandocNotFound](Figures/PandocNotFound.PNG)\n",
+    "\n",
+    "Overstående viser hvad der står, *hvis pandoc **ikke** virker*.\n",
+    "\n",
+    "![PandocFound](Figures/IngenOutput.PNG)\n",
+    "\n",
+    "Ovenstående viser hvad der står, *hvis pandoc faktisk virker*.\n",
+    "\n",
+    "Hvis det ikke virker for dig, så tjek at du har installeret det korrekt her [https://pandoc.org/installing.html](Figures/https://pandoc.org/installing.html)\n",
+    "\n",
+    "## MikTex/MacTex\n",
+    "\n",
+    "På samme måde som Pandoc, kan vi undersøge om MikTex er blevet installeret korrekt, og om PATH er blevet indsat korrekt ved bare én kommando i en terminal. Der følger to billeder der beskriver hvordan det ser ud, både når det virker, og når det ikke gør!\n",
+    "\n",
+    "![XelatexNotFound](Figures/XelatexNotFound.PNG)\n",
+    "\n",
+    "Ovenstående viser hvad der står, *hvis MikTex/MacTex samt alle steps derindimellem **ikke** virker*.\n",
+    "\n",
+    "![XelatexFound](Figures/XelatexWorking.PNG)\n",
+    "\n",
+    "Ovenstående viser hvad der står, *hvis alt der har noget med MikTex/MacTex at gøre faktisk virker*.\n",
+    "\n",
+    "Hvis det ikke virker, så sørg for at det er installeret (Windows: [MikTex](Figures/https://miktex.org), Mac (den lille pakke burde være nok, hvis du har meget lidt plads på computeren): [MacTex](Figures/https://tug.org/mactex/)). Hvis det stadig ikke virker og du er på Mac, sørg så for at køre følgende kommando i en terminal (der kommer ikke noget output, hvis jeg husker rigtigt) ``export PATH=/Library/TeX/texbin:$PATH``\n",
+    "\n",
+    "Hvis MikTek ikke virker for dig på Windows, kan det være tilfældet, at du aldrig fik tilføjet den PATH der, eller fik det gjort helt korrekt. For dem, har jeg her vedhæftet et billede af hvordan jeg gjorde det. Det kan være, at du på det sidste vindue skal trykke på \"ny\" før du indsætter stien til hvor MikTex ligger. Dette er her hvor min ligger, skrevet ind i korrekt format. Det sted hvor den installeres som standard er muligvis på stien ``C:\\Users\\<dit_brugernavn>\\AppData\\Local\\MiKTeX\\miktex\\bin\\x64``.\n",
+    "![HvordanFinderManPath](Figures/EditPath.PNG)\n",
+    "\n",
+    "## nbconvert\n",
+    "\n",
+    "Du kan også undersøge, om python kan finde \"nbconvert\" ved at åbne en terminal, køre python (eller python3) for at starte python, og derefter forsøge at importere denne pakke. Et eksempel, som smider en fejl er følgende:\n",
+    "\n",
+    "![HvordanFinderManPath](Figures/nbconvert.PNG)\n",
+    "\n",
+    "Hvis dette er tilfældet, så prøv at køre følgende kommando (i en ny terminal, efter du har lukket denne):\n",
+    "\n",
+    "``python -m pip install nbconvert``\n",
+    "\n",
+    "Hvis den klager over, at den ikke kan finde \"python\", kan det være du skal køre med \"python3\" i stedet. På samme måde, hvis den siger, \"No module named pip\", så prøv at køre med \"pip3\" i stedet for. Nu kan du prøve at genstarte terminalen, og du skal helst nu ikke få den fejl. Prøv at genstarte VS Code (step 1), og prøv igen!\n",
+    "\n",
+    "# Hvis direkte export til PDF virker for nogle filer, men ikke for alle\n",
+    "\n",
+    "Det er desværre sådan, at der er ting der kan skrives, og ser godt ud i VS code, men som gør at man ikke kan exportere til pdf pænt. Jeg har listet dem, som jeg har fundet endnu nedenunder. Der kommer desværre ingen god fejl-besked ud, så dette er bare nogle jeg har fundet \"blindt\". Dette er vel vidende, at *der helt sikkert er flere fejl end disse*. I en eksamens-situation, ville jeg altid bare konvertere til HTML og så til PDF. \n",
+    "\n",
+    "1) Brug af \"\\\\bm{x}\" for bold math giver en fejl. Brug i stedet \"\\\\mathbf{x}\"\n",
+    "\n",
+    "2) Brug af \"enkelt backslash\" i markdown mode hvis du vil vise et \"backslash\". Hvis du gerne vil have et backslash printet til skærmen, brug i stedet dobbelt backslash.\n",
+    "\n",
+    "3) Mellemrum inden i \"equation\" i markdown! Disse kan virkeligt gemme sig, og være enormt svære at finde! Et billede af hvordan det gøres korrekt sammenlignes herunder med hvordan det gøres forkert,\n",
+    "\n",
+    "![HvordanFinderManPath](Figures/SpaceEquation.PNG)\n",
+    "\n",
+    "Den kan især være svær at finde, da dette faktisk ikke er et krav i alle felter (bmatrix og matrix burde virke helt fint uden), men skrig og rædsel, hvis det er i en equation. Min anbefaling er at fjerne alle linje mellemrum i ligninger!\n",
+    "\n",
+    "## Hvis den giver fejl når du har billeder i din notebook\n",
+    "\n",
+    "Hvis den virker fint i din notebook, men stadig giver en fejl når du forsøger at eksportere den til pdf, kan du prøve følgende. Jeg er stadig ikke ekspert i billeder i notebooks, men dette kan muligvis virke. \n",
+    "\n",
+    "### HTML til pdf\n",
+    "\n",
+    "Prøv at gemme filen som HTML, derefter til pdf. Dette er absolut ikke den pæneste måde at gøre det på, men det burde have billederne med.\n",
+    "\n",
+    "### Pæn pdf\n",
+    "\n",
+    "Prøv først: `jupyter nbconvert \"filename.ipynb\" --to pdf`\n",
+    "\n",
+    "Hvis dette ikke virker, så prøv manuelt at gå via en tex-fil. Følgende 2 linjer kode i terminalen er den \"advancerede metode\" som tilfældigvis virker bedre med hensyn til billeder. Prøv at se, om ikke dette virker (med filename erstattet med filens navn. Hvis der er mellemrum i filnavnet, er dobbeltquotes rundt om filnavnet et krav):\n",
+    "\n",
+    "`jupyter nbconvert \"filename.ipynb\" --to latex`\n",
+    "\n",
+    "`xelatex \"filename.tex\"`\n",
+    "\n",
+    "# Hvis ikke konvertering til pdf gennem html virker!\n",
+    "\n",
+    "Hvis du har en notebook der ikke kan konvertere til pdf først gennem html, så kom lige og tal med en hjælpelærer. Worst case, til en eksamen, så bare aflever en notebook fil (.ipynb extention), men vi vil virkeligt gerne have, at dette *altid* virker!"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3.10.6 ('mat1-pilot': venv)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.6"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "0ba7452ab71c50cb9c4d5c0b7e104e5d7d626d39ddaf30384c30e1499f7a54e3"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}