una proposta per una nuova guida

claudio” post=91432una proposta
abbiamo delle buone guide ma
mancano delle FAQ
Come produrle ?
utilizzando il materiale del forum
come ?
con git
premetto che sono alle rime armi

ho creato un repository
https://github.com/trim1962/forum.git

e vi ho messo questo
`
\documentclass[a4paper]{book}
\usepackage[
left=2cm, right=2cm,
paper=a4paper,%
centering,%
pdftex,%
vcentering,%
]{geometry}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage[italian]{babel}
\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage[utf8]{inputenc}
\usepackage{imakeidx}
\makeindex[title=domanda]
\makeindex[name=autoreidx,title=Autori]
\makeindex[name=categoriaidx,title=Categorie]
\usepackage[italian]{varioref}

\usepackage{quoting}
\usepackage{tcolorbox}

\newenvironment{domanda}[3]{\begin{tcolorbox}[colback=red!5,colframe=red!75!black,title=#1]
Autore: #2\\
Categoria: #3
\index{#1}\index[autoreidx]{#2}\index[categoriaidx]{#3}\tcblower
}{\end{tcolorbox}\bigskip}

\newenvironment{risposta}[1]{\begin{tcolorbox}[colback=green!5,colframe=green!60!black,title= Risponde #1]\index[autoreidx]{#1}}{\end{tcolorbox}\bigskip}

\usepackage{listings}
\addto\captionsitalian{%
\renewcommand{\lstlistingname}{Codice}}
\addto\captionsitalian{%
\renewcommand{\lstlistlistingname}{Elenco dei codici}}
\lstset{basicstyle=\small\ttfamily,
keywordstyle=\color{black}\bfseries,
commentstyle=\color{darkgray},
stringstyle=\color{black},
showstringspaces=true}

\title{Come si fa per}
\author{Forum Guit}

\begin{document}
\frontmatter
\maketitle
\tableofcontents
\lstlistoflistings
\mainmatter
\input{grafica}
\input{bibblio}
\input{generale}
\backmatter
\markboth{\indexname}{\indexname}
\addcontentsline{toc}{chapter}{\indexname}
\printindex
\printindex[autoreidx]
\printindex[categoriaidx]
\end{document}
`

grafica.tex
`
\chapter{Grafica}
\label{chap:grafica}
\section{Tikz}
\label{sec:rikz}
\subsection{Scalare una tikzpicture}

%
\begin{domanda}{Scalare una tikzpicture}{claudio}{Tikz}
Come scalare una tikzpicture?
ciao
claudio
\end{domanda}

\begin{risposta}{Enrico Gregorio}
\begin{lstlisting}{Scalare una tikzpicture}
\scalebox{0.8}{%
\begin{tikzpicture}[ ]
\end{tikzpicture}%
}
\end{lstlisting}
\end{risposta}

`
bibblio.tex

`
\chapter{Bibliografia}
\label{chap:Bibliografia}
\section{Biber}
\label{sec:biber}
\subsection{Biber non funziona}
%\begin{quoting}
\begin{domanda}{Errore nell'esecuzione di biber}{Marco87}{Biber}
Ciao a tutti,
qualche giorno fa sono passato dall'uso di bibtex a quello di biber. Nel preambolo ho scritto:
%\end{quoting}

\begin{lstlisting}
\usepackage[babel,italian=guillemets]{csquotes}
\usepackage[backend=biber,style=philosophy-modern,
backref,ibidtracker=false]{biblatex}
\addbibresource{bibliografia.bib}
\end{lstlisting}

Fino a ieri compilando nella sequenza pdfLaTeX, biber, pdfLaTeX, pdfLaTeX, la bibliografia e le relative

citazioni nel testo mi venivano correttamente generati. Ora invece quando lancio biber mi viene dato questo messaggio d'errore:
data source \verb!C:\Users\Marco\AppData\Local\Temp\par-4d6172636f!
\verb!\cache-333197c21680a7a4ad2a7fa07276748f0070f0a5\recode_data.xml! not found in . Compilation failed in require at Biber/Utils.pm line 20. BEGIN failed–compilation aborted at Biber/Utils.pm line 20. Compilation failed in require at Biber/Internals.pm line 8. BEGIN failed–compilation aborted at Biber/Internals.pm line 8. Compilation failed in require at (eval 24) line 2. …propagated at C:/strawberry/perl/lib/base.pm line 94. BEGIN failed–compilation aborted at Biber.pm line 5. Compilation failed in require at script/biber-MSWIN line 17. BEGIN failed–compilation aborted at script/biber-MSWIN line 17.

E non viene generato alcun file .bbl. Non ho idea di cosa si tratti, e tanto meno di come provare a risolverlo, visto che non capisco molto del messaggio d'errore. Qualcuno sa dirmi come posso risolvere questo problema?

Grazie e buona giornata,
Marco.
\end{domanda}
\begin{risposta}{Enrico Gregorio}
Devi cancellare la cartella

\verb!C:\Users\Marco\AppData\Local\Temp\par-4d6172636f! con tutto ciò che contiene.

Capita di tanto in tanto; in questi casi, trovi la cartella da eliminare nel messaggio di errore.

Ciao
Enrico

\end{risposta}
`
generale.tex
`
\chapter{TeX e LaTeX}
\label{chap:texelatex}
\section{Generale}
\label{sec:Texgenerale}
\subsection{Gestione discussione}

\begin{domanda}{domanda e risposta}{claudio}{Tex e Latex}
come fare per gestire dei blocchi come questo
Domanda \verb!! Autore \verb!< Nome autore >! \verb!\index{nome}!
blocco della domanda bla bla bla bla bll
Risposta : Autore risposta \verb!< Nome autore>\index{Nome}!
blocco della risposta bla bla bla
ciao
claudio
\end{domanda}
\begin{risposta}{cfiandra}
\begin{lstlisting}{}
\documentclass{article}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage[italian]{babel}
\usepackage{tcolorbox}
\newenvironment{domanda}[3]{
\begin{tcolorbox}[width=\textwidth,colback=red!5,
colframe=red!75!black,title=#1]%
Autore: #2\\
Categoria: #3
\tcblower
}{\end{tcolorbox}\bigskip}
\newenvironment{risposta}[1]{
\begin{tcolorbox}
[width=\textwidth,colback=green!5,
colframe=green!60!black,title=#1]} %
{\end{tcolorbox}\bigskip}
\begin{document}
\begin{domanda}{domanda e risposta}{claudio}{\TeX{}e\LaTeX{}}
come fare per gestire dei blocchi come questo
Domanda \verb!!
Autore \verb!< Nome autore >! \verb!\index{nome}!
blocco della domanda bla bla bla bla bll
Risposta : Autore risposta
\verb!< Nome autore>\index{Nome}!
blocco della risposta bla bla bla
ciao
claudio
\end{domanda}
\begin{risposta}{OldClaudio}
Vuoi mantenere domanda e risposta unite,
senza salti di pagina in mezzo? O che cosa intendi
per “gestire''?
\end{risposta}
\begin{risposta}{claudio}
in pratica vorrei fare una raccolta di domande e risposte
di questo forum quindi non ho idea della domanda e della
risposta e della loro strutturazione impossibile da gestire?
ciao
claudio
\begin{risposta}{OldClaudio}
Impossibile non saprei, a difficile senz'altro, molto difficile;
pensa a un topic qualsiasi; uno fa una domanda e riceve via via
dieci risposte delle quali una solleva un polverone,su cui si
scatenano altre risposte che spesso non hanno nulla a che vedere con la prima
domanda; oppure che generano alte domande nello stesso filone.
Le risposte cominciano ad intrecciarsi e non si capisce pi\'u
chi stia rispondendo a chi, sebbene la lettura del filone di
discussione sia spesso molto interessante per la variet\'a
dei punti di vista e per la dinamica che nasce a chi, sebbene la
lettura del filone di discussione sia spesso molto interessante
per la variet\'a dei punti di vista e per la dinamica che nasce
da questi dialoghi “in piazza'', “nel foro (romano)''
\end{risposta}
\begin{risposta}{claudio}
non tutte le risposte sarebbero riprese ma solo quella che risolve il problema.
ciao
\end{risposta}
\end{document}
\end{lstlisting}

\end{risposta}
`

il codice è certamente perfezionabile
ma questo è lo scopo di tutto
in pratica si tratta di raccogliere buone risposte e metterle via
che ne pensate?
claudio

L’iniziativa è interessante.
Esistono già alcune FAQ, quella famosa in seno al TUG: http://www.tex.ac.uk/cgi-bin/texfaq2html?introduction=yes
ed anche quella del nostro sito http://www.guitex.org/home/it/faq

Sarebbe utile ‘assorbire’ la FAQ della home page del sito GuITeX.org, quidni servirebbe sviluppare le domande e le risposte in un formato duplice html/pdf. Per far questo si potrebbe usare pandoc.
Credo infatti che le FAQ siano un riferimento veloce a portata di click. Se sono contenute in un pdf perdono un po’ della logica FAQ.

Facci sapere se ti serve un repo ufficiale su https://github.com/GuITeX .
Grazie.
R.