The easiest is to just build the project you need, as in `project
akka-actor; publishLocal`.
You can disable generating PDFs by setting: enableOutput in
generatePdf := false
in the build (or REPL via `set ...`)

We're using the sbt-site plugin to do this:
https://github.com/sbt/sbt-site/blob/fcea3921a56f3827c5b3d50dcfcd7e850f21d663/src/main/scala/com/typesafe/sbt/site/SphinxSupport.scala

In general though it seems like perhaps you didn't install all required
modules for latex?
The docs build for me and on jenkins, so the code itself should be fine.

Hope this helps.

-- Konrad

On Thu, Apr 2, 2015 at 9:43 AM, Leszek Gruchała <[email protected]>
wrote:

> Thanks a lot. It would be helpful to have reference to this documentation
> on Building Akka page :-)
>
> I got another problem with only PDF generation, here’s the end of the
> error:
>
> [debug] LaTeX Warning: Hyper reference `common/cluster:niy' on page 259
> undefined on in
> [debug] put line 18510.
> [debug]
> [debug] ! Undefined control sequence.
> [debug] <argument> \node@class@name
> [debug]
> [debug] l.18517 ...ection{Partitioning \DUspan{}{{[}*{]}}}
> [debug]
> [debug] ?
> [debug] ! Emergency stop.
> [debug] <argument> \node@class@name
> [debug]
> [debug] l.18517 ...ection{Partitioning \DUspan{}{{[}*{]}}}
> [debug]
> [debug] !  ==> Fatal error occurred, no output PDF file produced!
> [debug] Transcript written on AkkaJava.log.
> [debug] make: *** [AkkaJava.pdf] Error 1
> java.lang.RuntimeException: Sphinx pdf generation failed.  See debug
> output for details.
> at scala.sys.package$.error(package.scala:27)
> at
> com.typesafe.sbt.sphinx.CommandLineSphinxRunner.makePdf(SphinxRunner.scala:146)
> at
> com.typesafe.sbt.sphinx.CommandLineSphinxRunner.generatePdf(SphinxRunner.scala:63)
> at
> com.typesafe.sbt.site.SphinxSupport$$anonfun$generatePdfTask$1.apply(SphinxSupport.scala:84)
> at
> com.typesafe.sbt.site.SphinxSupport$$anonfun$generatePdfTask$1.apply(SphinxSupport.scala:84)
> at scala.Function5$$anonfun$tupled$1.apply(Function5.scala:35)
> at scala.Function5$$anonfun$tupled$1.apply(Function5.scala:34)
> at scala.Function1$$anonfun$compose$1.apply(Function1.scala:47)
> at sbt.$tilde$greater$$anonfun$$u2219$1.apply(TypeFunctions.scala:40)
> at sbt.std.Transform$$anon$4.work(System.scala:63)
> at sbt.Execute$$anonfun$submit$1$$anonfun$apply$1.apply(Execute.scala:226)
> at sbt.Execute$$anonfun$submit$1$$anonfun$apply$1.apply(Execute.scala:226)
> at sbt.ErrorHandling$.wideConvert(ErrorHandling.scala:17)
> at sbt.Execute.work(Execute.scala:235)
> at sbt.Execute$$anonfun$submit$1.apply(Execute.scala:226)
> at sbt.Execute$$anonfun$submit$1.apply(Execute.scala:226)
> at
> sbt.ConcurrentRestrictions$$anon$4$$anonfun$1.apply(ConcurrentRestrictions.scala:159)
> at sbt.CompletionService$$anon$2.call(CompletionService.scala:28)
> at java.util.concurrent.FutureTask.run(FutureTask.java:266)
> at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
> at java.util.concurrent.FutureTask.run(FutureTask.java:266)
> at
> java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
> at
> java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
> at java.lang.Thread.run(Thread.java:745)
> [error] (akka-docs/sphinx:generatePdf) Sphinx pdf generation failed.  See
> debug output for details.
>
> Is it possible to disable documentation generation?
>
>
>
> --
> Leszek Gruchała
> gruchala.eu <http://www.gruchala.eu/>
>
> On 2 Apr 2015 at 09:20:55, Konrad Malawski ([email protected])
> wrote:
>
>  Hi Leszek,
> Are you sure you have the sphinx-build command available? It’s not
> complaining about the directory, it is complaining about the lack of
> sphinx.
>
> Have you installed Sphinx?
> Here’s how: http://doc.akka.io/docs/akka/snapshot/dev/documentation.html
>
>  --
>  Cheers,
> Konrad 'ktoso’ Malawski
> Akka <http://akka.io> @ Typesafe <http://typesafe.com>
>
> On 2 April 2015 at 09:18:26, Leszek Gruchała ([email protected])
> wrote:
>
>  Hi,
> I am trying to build Akka from master branch.
> I do
>  sbt -Dakka.scaladoc.diagrams=false publish-local
>  and as result I get
>
>  [error] (akka-docs/sphinx:generateEpub) java.io.IOException: Cannot run
> program "sphinx-build" (in directory
> "/Users/lgr/projects/opensource/akka/akka-docs/rst_preprocessed"): error=2
> , No such file or directory
> [error] (akka-docs/sphinx:generatePdf) java.io.IOException: Cannot run
> program "sphinx-build" (in directory
> "/Users/lgr/projects/opensource/akka/akka-docs/rst_preprocessed"): error=2
> , No such file or directory
> [error] (akka-docs/sphinx:generateHtml) java.io.IOException: Cannot run
> program "sphinx-build" (in directory
> "/Users/lgr/projects/opensource/akka/akka-docs/rst_preprocessed"): error=2
> , No such file or directory
>
>  But this is not true
>
>  08:52 $ cd /Users/lgr/projects/opensource/akka/akka-docs/
> 08:52 $ ls
> _sphinx build.sbt rst rst_preprocessed target
>
>
>  last akka-docs/sphinx:generateEpub
>
> [info] Generating Sphinx epub documentation...
> [debug] Command: sphinx-build -a -E -b epub -d /Users/lgr/projects/
> opensource/akka/akka-docs/target/sphinx/doctrees/epub -Dversion=2.4-
> SNAPSHOT -Drelease=2.4-SNAPSHOT /Users/lgr/projects/opensource/akka/akka-
> docs/rst_preprocessed /Users/lgr/projects/opensource/akka/akka-docs/target
> /sphinx/epub
> [debug] Environment: Map(PYTHONPATH -> /Users/lgr/projects/opensource/akka
> /akka-docs/target/sphinx/packages/pygments)
> java.io.IOException: Cannot run program "sphinx-build" (in directory
> "/Users/lgr/projects/opensource/akka/akka-docs/rst_preprocessed"): error=2
> , No such file or directory
>  at java.lang.ProcessBuilder.start(ProcessBuilder.java:1048)
>  at sbt.SimpleProcessBuilder.run(ProcessImpl.scala:349)
>  at sbt.AbstractProcessBuilder.run(ProcessImpl.scala:128)
>  at sbt.AbstractProcessBuilder$$anonfun$runBuffered$1.apply(ProcessImpl.
> scala:159)
>  at sbt.AbstractProcessBuilder$$anonfun$runBuffered$1.apply(ProcessImpl.
> scala:159)
>  at com.typesafe.sbt.sphinx.CommandLineSphinxRunner$$anon$1.buffer(
> SphinxRunner.scala:159)
>  at sbt.AbstractProcessBuilder.runBuffered(ProcessImpl.scala:159)
>  at sbt.AbstractProcessBuilder.$bang(ProcessImpl.scala:156)
>  at com.typesafe.sbt.sphinx.CommandLineSphinxRunner$$anonfun$1.apply(
> SphinxRunner.scala:119)
>  at com.typesafe.sbt.sphinx.CommandLineSphinxRunner$$anonfun$1.apply(
> SphinxRunner.scala:104)
>  at sbt.FileFunction$$anonfun$cached$2$$anonfun$apply$3$$anonfun$apply$4.
> apply(Tracked.scala:200)
>  at sbt.FileFunction$$anonfun$cached$2$$anonfun$apply$3$$anonfun$apply$4.
> apply(Tracked.scala:196)
>  at sbt.Difference.apply(Tracked.scala:175)
>  at sbt.Difference.apply(Tracked.scala:157)
>  at sbt.FileFunction$$anonfun$cached$2$$anonfun$apply$3.apply(Tracked.
> scala:196)
>  at sbt.FileFunction$$anonfun$cached$2$$anonfun$apply$3.apply(Tracked.
> scala:195)
>  at sbt.Difference.apply(Tracked.scala:175)
>  at sbt.Difference.apply(Tracked.scala:151)
>  at sbt.FileFunction$$anonfun$cached$2.apply(Tracked.scala:195)
>  at sbt.FileFunction$$anonfun$cached$2.apply(Tracked.scala:193)
>  at com.typesafe.sbt.sphinx.CommandLineSphinxRunner.sphinxBuild(
> SphinxRunner.scala:126)
>  at com.typesafe.sbt.sphinx.CommandLineSphinxRunner.generateEpub(
> SphinxRunner.scala:67)
>  at com.typesafe.sbt.site.SphinxSupport$$anonfun$generateEpubTask$1.apply(
> SphinxSupport.scala:88)
>  at com.typesafe.sbt.site.SphinxSupport$$anonfun$generateEpubTask$1.apply(
> SphinxSupport.scala:88)
>  at scala.Function5$$anonfun$tupled$1.apply(Function5.scala:35)
>  at scala.Function5$$anonfun$tupled$1.apply(Function5.scala:34)
>  at scala.Function1$$anonfun$compose$1.apply(Function1.scala:47)
>  at sbt.$tilde$greater$$anonfun$$u2219$1.apply(TypeFunctions.scala:40)
>  at sbt.std.Transform$$anon$4.work(System.scala:63)
>  at sbt.Execute$$anonfun$submit$1$$anonfun$apply$1.apply(Execute.scala:226
> )
>  at sbt.Execute$$anonfun$submit$1$$anonfun$apply$1.apply(Execute.scala:226
> )
>  at sbt.ErrorHandling$.wideConvert(ErrorHandling.scala:17)
>  at sbt.Execute.work(Execute.scala:235)
>  at sbt.Execute$$anonfun$submit$1.apply(Execute.scala:226)
>  at sbt.Execute$$anonfun$submit$1.apply(Execute.scala:226)
>  at sbt.ConcurrentRestrictions$$anon$4$$anonfun$1.apply(
> ConcurrentRestrictions.scala:159)
>  at sbt.CompletionService$$anon$2.call(CompletionService.scala:28)
>  at java.util.concurrent.FutureTask.run(FutureTask.java:266)
>  at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511
> )
>  at java.util.concurrent.FutureTask.run(FutureTask.java:266)
>  at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.
> java:1142)
>  at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.
> java:617)
>  at java.lang.Thread.run(Thread.java:745)
>
>  Thanks for help,
> Leszek
>
>
>  --
> >>>>>>>>>> Read the docs: http://akka.io/docs/
> >>>>>>>>>> Check the FAQ:
> http://doc.akka.io/docs/akka/current/additional/faq.html
> >>>>>>>>>> Search the archives: https://groups.google.com/group/akka-user
> ---
> You received this message because you are subscribed to the Google Groups
> "Akka User List" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To post to this group, send email to [email protected].
> Visit this group at http://groups.google.com/group/akka-user.
> For more options, visit https://groups.google.com/d/optout.
>
>  --
> >>>>>>>>>> Read the docs: http://akka.io/docs/
> >>>>>>>>>> Check the FAQ:
> http://doc.akka.io/docs/akka/current/additional/faq.html
> >>>>>>>>>> Search the archives: https://groups.google.com/group/akka-user
> ---
> You received this message because you are subscribed to the Google Groups
> "Akka User List" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To post to this group, send email to [email protected].
> Visit this group at http://groups.google.com/group/akka-user.
> For more options, visit https://groups.google.com/d/optout.
>



-- 
Akka Team
Typesafe - Reactive apps on the JVM
Blog: letitcrash.com
Twitter: @akkateam

-- 
>>>>>>>>>>      Read the docs: http://akka.io/docs/
>>>>>>>>>>      Check the FAQ: 
>>>>>>>>>> http://doc.akka.io/docs/akka/current/additional/faq.html
>>>>>>>>>>      Search the archives: https://groups.google.com/group/akka-user
--- 
You received this message because you are subscribed to the Google Groups "Akka 
User List" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/akka-user.
For more options, visit https://groups.google.com/d/optout.

Reply via email to