Asciidoc Maven Build PDF links not Working - asciidoc

I am using the asciidoctor-maven-plugin to create a PDF User Guide from asciidoc source files.
I use the following format for cross references within the adoc files:
link:overview/name_of_file.adoc[Link name]
But the link is rendered as follows in the PDF:
file:///<local path>/overview/name_of_file.adoc
That is, the links the don't work. How to generate working links in the PDF (but also retain an .adoc link format that works in the source file for use in bitbucket)?
Output is one PDF

Related

How do I embed full pdfs using ReStructured Text?

How do I embed a pdf using reStructured Text? With the following directive, I only get the first page.
.. image:: /pdfs/cv.pdf
For context, I'm trying to do this in a Pelican based blog.
A plugin for Pelican called pdf-img description says:
Searches for any tags within your article for which the source is a PostScript, EPS, or PDF file. It will produce a PNG preview of the file and this PNG will be displayed as the image. This preview will also act as a link to the original file. If the PDF/PS/EPS file is a multi-page document, then only the first page will be used for the preview.
That explains why you get those results.
I could find no plugin that "embeds a PDF" (by which I assume you want to embed a PDF viewer within your Pelican blog that would display the entire PDF, allowing the viewer to scroll through it in an iframe or something like that), but you can try searching for others.

Sphinx contents search results

I am currently using the read the doc theme for sphinxdoc version 1.4.6. When I search contents the queries display the title and the start of restructure text files instead of the the title and start of the html page. Is there any possible way I can change that?
Try the sphinx extension "sphinxprettysearchresults" (https://pypi.python.org/pypi/sphinxprettysearchresults).
Their website says this:
To display search results, Sphinx is fetching the source files of search hits and rendering excerpts in raw markup (Example).
This extension removes the markup from these source files (during build time), so the search results look decent.
However, when I load it on my project, I get an error, which I will have to report.
Maybe it works fine in your project.

How to link from a Sphinx document into a CHM file?

How can I link from a Sphinx document into a CHM file?
It seems that I could link from one chm file into another using a syntax like
<a href="ms-its:path+filename.chm::/pagename.htm">
Is it possible to transfer this into Sphinx commands?
You know, opening a topic compiled into a CHM is possible with Microsoft Internet Explorer only (!) by adding following code in a HTML file:
<p>Sample of CHM link to a topic in a compiled help file that is stored on a local computer</p>
<!-- To link to a topic in a compiled help file that is stored on a local computer, create a link using the following syntax: -->
Link to Garden topic here
I think, the reStructuredText parser cannot transfer these special kind of link from the source (reST).
But you can use the Replacement Text like shown below. Please note, the backslash is used twice:
================
Replacement Text
================
I recommend you try |HTMLHelp|_ and continue compiling help in CHM file format.
.. |HTMLHelp| replace:: CHM, *the* best help format around
.. _HTMLHelp: ms-its:D:\\UserData-Sphinx\\CHM-example.chm::/garden/garden.htm
The "replace" directive is used to indicate replacement text for a substitution reference. It may be used within substitution definitions only.
The resulting HTML file view:
The compiled help CHM:
The topic garden.htm is shown in the Help Viewer's topic pane after the link iswas clicked:
You may download the above used CHM-example.chm file from my HTMLHelp (HH) info site see download section or download CHM.
Please note, to open this CHM file right-click the saved file, click Properties, and then click Unblock.

Attach a already created pdf with a new pdf generated with DOM PDF in codeigniter

I am creating a PDF file using DOM pdf and codeigniter as my framework. In that PDF i want to attach already saved PDF's on my server at the end of newly created PDF file. Is that possible with DOM PDF to create a PDF like that.
Presently DOM PDF will not support for merging two pdf files
You can do with PDFTK.
Or
Refer this :
Merge multiple PDF files into one in PHP

How can I create a download link in octopress

I'm using Octopress for my blog and need to create a link to download a text file.
There is a built in plugin called include_code that renders a link but also shows the file. I just want the link. Does anyone know how I can do this?
Put your text file under source/downloads/code
Then you can use the markdown syntax for showing links like this :
[link name](url for the txt file)
The url will be {your blog url}/downloads/code/{name of txt file}
This is derived from the include_code plugin which also shows a download link for each code listing.
UPDATE :
To do it from within HTML, you can use
Text File

Resources