Välkommen till linuxportalen.se!

Linuxportalen.se är Sveriges största och aktivaste webbplats för användare av öppen- och fri programvara.

Du besöker Linuxportalen.se som gäst vilket begränsar din möjlighet att använda webbplatsens alla funktioner. Genom att registera dig som medlem får du inte bara möjlighet att söka bland webbplatsens innehåll, skapa nya och delta i befintliga diskussioner, skapa din egen blogg, kommunicera med andra medlemmar genom privata meddelanden och delta i omröstningar. Du får också tillgång till Veckans Kadavro - en seriestrip unikt skapad för Linuxportalen.se!

Registeringen sker snabbt och är helt kostnadsfri - tveka inte, bli medlem idag!

Dokumentation, format & verktyg?

Jag skall inom kort sätta mig och författa en grundlig manual så att våra kära konsulter får möjlighet att ta del av min allomfattande visdom vad gäller affärslogikens fromma.. *harkel*

På den firma där jag sitter och slavar för brödet är det vedertagen rutin att dokumentation givetvis skall göras i den senaste versionen av Microsoft Windows förnäma ordbehandlare då allt annat måste betecknas som hädelse och kontrarevolutionär verksamhet. Slika odygder måste bestraffas anser man på HK, ändock känner jag mig mer pragmatisk än lydig för tillfället så en osympatisk tanke har faktiskt slagit rot, just tanken att man bör dokumentera på ett sådant sätt att man enkelt kan generera dokument i önskat format med ett simpelt ingrepp. Somliga må föredra .doc men sunda perosner äskar .pdf och vår webserver anser troligen att .html kunde vederkvicka.

Problemet är att undertecknad saknar all form av insikt i ämnet. Det finns något som heter docbook, är det vad jag bör snegla på? Finns där vettiga editorer och verktyg eller är det emacs som skall in på burken. (somliga höjer här ett välansat ögonbryn och undrar varför emacs undantas ifrån kategoriseringen "vettiga editorer" - det är en ren tillfällighet, heders..)

Alla råd emottages ödmjukt och tacksamt.

Alternativ för kommentarvisning

Välj ditt önskade sätt att visa kommentarerna och klicka på "Spara" för att verkställa dina ändringar.

mikaeljs bild

Både OO Writer och Scribus erbjuder smidiga miljöer där du kan exportera arbete till exempelvis pdf. Jag vågar påstå att dessa inte behöver nåt jättearbete i form av inlärning. Smile



 



~~~ Have a goodyear - http://www.youtube.com/watch?v=tO2wb-LarfU ~~~

 

mikaeljs bild

Om du vill titta vidare på docbook så finns följande sida när det gäller editorer:
http://wiki.docbook.org/topic/DocBookAuthoringTools



 



~~~ Have a goodyear - http://www.youtube.com/watch?v=tO2wb-LarfU ~~~

 

iveqys bild

Jag rekommenderar att du läser det här:
http://oestrem.com/thingstwice/?p=65

Sedan blir du frälst på LaTeX och behöver läsa det här:
http://www.ddg.lth.se/perf/handledning/tryck-a4.pdf
och kanske fylla på med det här:
http://www.ctan.org/tex-archive/info/lshort/english/lshort.pdf
Ska du visa kod rekommenderar jag:
ftp://mirrors.dotsrc.org/ctan/macros/latex/contrib/fancyvrb/fancyvrb.pdf

Till detta underlättar det med en bra texteditor. Vill du inte lära dig LaTeX så kan du alltid testa LyX. Annars rekommenderar jag som vanligt vim, men tänk på den höga inlärningskurvan!

nightfalls bild

Jag har inte använt det själv men reStructuredText kanske kan vara ett alternativ.
Hittade även den här sidan som tar upp några olika alternativ: http://bluebones.net/2005/02/humane-text-formats/

elwiss bild

LaTex vet jag att en kollega kladdat i, skall läsa din länk. Problemet här skulle väl vara om undertecknad lämnar skeppet .. LaTex har väl en tröskel som inte "vem-som-helst" kan snappa upp och överta på en halvdag.

iveqys bild

LaTeX har en tröskel. Det tar tid att bli riktigt duktig i det. Inlärningstiden innan man kan använda LaTeX väldigt kort (15-30 min).

Har man dessutom färdiga dokument att ändra i eller använda som mall går det ännu snabbare om man ska göra krångliga saker.

Det är inte svårare än html, det finns bra dokumentation (på svenska till och med som du såg).

elwiss bild

Hmm, LyX verkar inte vara en höjdare på vista - det gick inte exportera till HTML t.ex och de fonter jag kört med vägrar visa å,ä,ö utan nöjer sig med "x".
Får nog ge mig på en annan editor Wink

iaidokas bild

Och så bygger man makefiler som typsätter och producerar pdf, html och vad man nu vill ha.

 
Test.

Test.

iveqys bild

japp, eller också så har ens texteditor redan gjort det åt dig...

iveqys bild

jag kör lyx på vista utan problem. Men varför ändrar du fonter och exporterar till html?

mikaeljs bild

Hur fungerar det med latex egentligen? Man skriver "taggar" för hur man vill att texten skall vara? Typ som i html...
Kan man automatisera detta utan att använda en wysiwyg editor? Jag som skriver mycket dokumentation tycker att arbetet blir avsevärt mer genom att behöva fokusera på sånt. Jag undviker att skriva dokumentation i html då jag vill slippa tänka på taggar. Kan man koppla kortkommandon till spefika "händelser"? Alltså att man kan trycka ctrl+b för att få fet osv...
.
Jag vet väldigt lite om latex vilket syns. Dock är man ju nyfiken Smile



 



~~~ Have a goodyear - http://www.youtube.com/watch?v=tO2wb-LarfU ~~~

 

elwiss bild

Jag var tvungen att testa andra fonter eftersom standard fonten inte verkade innehålla å,ä,ö - det byttes ut emot xxx.
Och export gör för att slutdokumentet kommer att publiceras som .pdf & .html, möjligen i någon .doc eller .rtf också.

DocBook kanske är lättare, finns tydligen stöd för det i eclipse och byggs med ant..

Kristians bild

Självklart kan du skriva en latex-generator Smile Det är ju ren text
När du väl har latex-kod kan du exportera till vad som helst

----------------------------------
MÖLUG

---------------------------------------

 

iveqys bild

Man kan mycket väl likna LaTeX vid HTML eftersom båda är såkallade "markup languages". Det är ungeför som att jämföra Visual Basic med C++. Båda är programmeringsspråk.

Det är alltså en textfil som du ska ha fram. En textfil skriver du enklast med en vanlig texteditor och beroende på vilken texteditor du använder så kan du få olika funktioner.

De enklaste texteditorerna (tex. Ms Notepad) kan söka och klipp och klistra. De mer avancerade och ordentliga editorerna kan göra precis allt du vill.

Jag skrivar LaTeX i vim som har ett ypperligt plugin just för att ta hand om LaTeX-kod.

iveqys bild

Nu tycker jag inte att du ska blanda äpplen med bananer. Välj det sätt att skriva dokumentation med men gör det av rätt anledningar. Givetvis har ecplise även stöd för LaTeX:
http://eclipse-latex.sourceforge.net/

och du kan använda ant, make, cmake eller vad du föredrar till att automatisera byggprocessen.

Är det verkligen miktex du använt till windows? Jag installerade miktex på min vista dator och alltingt har fungerat "out-of-the-box".

Hur ser källkoden till ditt dokument ut?

mikaeljs bild

hmmm...



 



~~~ Have a goodyear - http://www.youtube.com/watch?v=tO2wb-LarfU ~~~

 

mikaeljs bild

Jag har använt linux och vi/vim i 11 år... jag vet hur man författar en textfil. Hade inget med vad jag var ute efter. Kristian gav ett vettigt svar...



 



~~~ Have a goodyear - http://www.youtube.com/watch?v=tO2wb-LarfU ~~~

 

iveqys bild

LaTeX är bara ett typsättningsprogram som tar en ren textfil och gör en dvi-fil av det (som sedan kan bli en ps-fil och sedan kanske en pdf-fil).

Det finns specialiserade LaTeX editorer så som LyX som mer liknar en ordbehandlare men genererar LaTeX-kod.

Vad trevligt att du är vim användare. Då vet du redan svaret på din fråga. Det går utmärkt att få fetstil med ctrl+b. Ctrl+b är tyvärr redan upptaget av "page up" men en idé är ju att mappa _b till feststil istället.

Lägg följande i din tex.vim fil i .vim/ftplugin/ så borde du få ungefär vad du är ute efter:

map _b :call Bold()<cr>

func! Bold()
     execute "normal a\\textbf{}"
endfunc

elwiss bild

Jag installerde bundlen så då drog den in imagemagick och miktex bl.a

Sitter hemma nu så jag har inte dokumentet här