distribute additional LaTeX files for better looking manual

doc/utils/sphinx-config/conf.py.in

@@ -57,6 +57,7 @@ extensions = [
     'table_from_list',
     'tab_or_note',
     'breathe',
+    'sphinx_design'
 ]
 
 images_config = {
@@ -68,7 +69,7 @@ images_config = {
 templates_path = ['_templates']
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = {'.rst': 'restructuredtext'}
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'
@@ -296,6 +297,7 @@ latex_elements = {
 \setcounter{tocdepth}{2}
 \renewcommand{\sfdefault}{ptm}  % Use Times New Roman font for \textrm
 \renewcommand{\sfdefault}{phv}  % Use Helvetica font for \textsf
+\usepackage[columns=1]{idxlayout} % create index with only one column
 % Set up math fonts to match text fonts
 \DeclareSymbolFont{operators}   {OT1}{ptm}{m}{n}
 \DeclareSymbolFont{bold}        {OT1}{ptm}{bx}{n}
@@ -340,6 +342,11 @@ latex_elements = {
 '''
 }
 
+# copy custom style file for tweaking index layout
+latex_additional_files = [
+    'latex/idxlayout.sty', 'latex/ellipse.sty',
+    'latex/pict2e.sty', 'latex/p2e-pdftex.def',
+]
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
@@ -382,6 +389,12 @@ man_pages = [
 #man_show_urls = False
 
 
+# strip off LAMMPS_NS:: from index entries
+cpp_index_common_prefix = [
+    'LAMMPS_NS::',
+    '_LMP_STYLE_CONST::', '_LMP_TYPE_CONST::', '_LMP_VAR_CONST::',
+]
+
 # -- Options for Texinfo output -------------------------------------------
 
 # Grouping the document tree into Texinfo files. List of tuples