CFD Online Discussion Forums

CFD Online Discussion Forums (
-   OpenFOAM (
-   -   Would like local doxygen search form to work (

unoder January 1, 2008 16:19

Hi, I don't know if this ac

I don't know if this actually is the right place to ask, but I guess its relevant to somebody here, so here we go: I would like to be able to browse the doxygen documentation while offline and not connected to the internet.

However, when I type something in the "search field" I get a "Opening search.php" form up saying that this file is a PHP script. Then Firefox asks me what it should do with it.

I guess I should install something for the PHP scripting to work offline - php server? I'm running opensuse 10.0 (or 10.1?). Perhaps I can use yast?

Just tell me what I should download and try to install, and I'll try to make it work.



gschaider January 2, 2008 05:30

Hi Martin! The "easiest" wa
Hi Martin!

The "easiest" way to browse offline on your machine (in my experienve) is to install a webserver with php, make the doxygen-directory accessible to it and point your webbrowser to


unoder January 3, 2008 07:36

Hi Bernhard, Thanks a lot f
Hi Bernhard,

Thanks a lot for the idea. The webserver now works for a very simple "index.html" file in /srv/www/htdocs/index.html (simply saying: "This works").

However, I currently got a problem with my apache configuration files I think - get an annoying "403 error - missing permission", but I think I'll solve that problem...

I see I need to change my DocumentRoot in /etc/apache2/default-server.conf and point it to the OpenFOAM/doc/Doxygen-directory (hmmm. or perhaps xxxx/Doxygen/html-directory, where the index.html file is)...

I hope I get it working... If anyone tried it, please tell how you modified your .conf-files in /etc/apache2. Or perhaps I'll figure it out myself, when I get a bit more time to google for an answer to the 403-error...


unoder February 2, 2008 21:56

Hi, In case anyone wants to

In case anyone wants to save some time and browse the documentation offline: I had a problem with Doxygen linking to C source files which it couldn't find so three steps were necessary to get a satisfactory behaviour:

1) I added a symbolic link in ~/OpenFOAM/OpenFOAM-1.4.1-dev/doc/Doxygen/html to
/home/martin/OpenFOAM/OpenFOAM-1.4.1-dev/src, which then makes the relative paths work by apache.

2) The content type of the C-source files were recognized as "text/C source file" so whenever I clicked on a source file, firefox asked me what to do with the file (download / save as etc.). The fix: "AddType text/plain C c CPP cpp"

3) Then the usual documentroot/directory settings must be right. Here's my "default-server.conf" file (suggestions and improvements are welcome - I don't know much about apache, but this seem to work nice locally - "Options FollowSymLinks" must be enabled for everything to work):

DocumentRoot "/home/martin/OpenFOAM/OpenFOAM-1.4.1-dev/doc/Doxygen/html"

# Possible values for the Options directive are "None", "All",
# or any combination of:
# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
# Note that "MultiViews" must be named *explicitly* --- "Options All"
# doesn't give it to you.
# The Options directive is both complicated and important. Please see
# for more information.
Options FollowSymLinks
# AllowOverride controls what directives may be placed in .htaccess files.
# It can be "All", "None", or any combination of the keywords:
# Options FileInfo AuthConfig Limit
AllowOverride None
# Controls who can get stuff from this server.
Order allow,deny
Allow from all

AddType text/plain C c CPP cpp

# Note that the name of the user directory ("public_html") cannot simply be
# changed here, since it is a compile time setting. The apache package
# would have to be rebuilt. You could work around by deleting
# /usr/sbin/suexec, but then all scripts from the directories would be
# executed with the UID of the webserver.
UserDir public_html
# The actual configuration of the directory is in
# /etc/apache2/mod_userdir.conf.
Include /etc/apache2/mod_userdir.conf

# Include all *.conf files from /etc/apache2/conf.d/.
# This is mostly meant as a place for other RPM packages to drop in their
# configuration snippet.
# You can comment this out here if you want those bits include only in a
# certain virtual host, but not here.
Include /etc/apache2/conf.d/*.conf

# The manual... if it is installed ('?' means it won't complain)
Include /etc/apache2/conf.d/apache2-manual?conf
ServerName laptop

ServerAdmin root@laptop


And the search-form / php-part works really great... Suse YAST-installer did everything for me (php5). Hope somebody can use the "recipe" (and else I might use it next time I forgot what I did and need to reinstall).

gschaider February 4, 2008 09:04

Hi Martin! Could you add th
Hi Martin!

Could you add this in the HowTo-secion of the Wiki? That would be great


unoder February 4, 2008 18:07

Sure Bernhard, I suppose yo
Sure Bernhard,

I suppose you meant to add it here?

And here's the link:

If anyone get trouble/suggestions/improvements/thinks it should somewhere else in the wiki-tree, please edit the wiki-entry... I don't pretend to be an expert here...

All times are GMT -4. The time now is 21:05.