New Members ⇒ Hello LaTeX World

[JBC]

Hello Everyone,

Bran new to the LaTeX world that's for sure...don't even know enough to be dangerous...but I can compile a PDF from a TEX file so there's that.

Thank you in advance for any help...it's very much appreciated!

Brett

[Johannes_B]

Hi and welcome to the community.

[Stefan Kottwitz]

Hi Brett,

welcome to the forum!

Feel free to post any question you have.

Stefan

[JBC]

Thank you Stefan...you may regret that offer...here goes.

My objective with LaTeX seems fairly complex...but that's probably just me.
I hope to share my overall objective, software and system, progress so far, and the piece that I'm trying to solve at this stage of the game to see if I'm walking down the right path. Thank you in advance.

Objective
The project is writing documentation in Markdown for a text editing program. The object is to write the content once, and then either convert it from Markdown to Tex and then finish the output to HTML, PDF, ePub & Mobi...
...OR...
...run the markdown through a script first to manually prepare it for becoming a TEX file that can then output the preferred formats.
Question 1: Is this even feasible, and even if it is, should I have high expectations for the output quality of each format?

Software
Running Windows 7, MikTex, flirted with Overleaf online, TeXworks is installed but 99% of my initial attempts have used a text editor to edit the file, then compiled at prompt with pdflatex file.tex. TikZ is also on my system but don't see the need for my doc. My system seems capable enough.

Progress
So I've been able to compile a VERY basic PDF to try and learn what the heck I'm doing. Adding \packages to the preamble, have them install automatically when needed etc.

Problem piece.
There are going to be approximately 1,500 references to software commands (one to 20 characters long) in this document. I've created a conceptual visual structure for these commands that I was hoping to implement with a \newcommand macro. An image is attached. The styling for this image is due to the settings in the next paragraph.

This provides the visual effect for each insertion seen in the attached file, colors are just for concept.
\colorbox{black}{\lstinline[basicstyle=\ttfamily\color{yellow}\large]|yy|}. I just haven't been able to figure out how to incorporate it into a \newcommand.

I've tried to grasp the \newcommand macro framework because it seems it would make the most sense based on the content volume but wow...I feel really stupid. Here's what I was thinking:

\newcommand{command}{description}{category?} etc.
\code{aa} {desc}
\code{bb} {desc}
\code{cc} {desc}
\code{dd} {desc}
\code{ee} all throughout the document. It seems the \newcommand could handle the formatting and everything would be formatted similar to the \colorbox setting above but can you imagine having that size string 1,000 times in a document? So besides the visual formatting, it looks like I'll need two parameters, {command} and {description}.

Future thoughts
Then there's the thought of multi column layout, index, table of contents, categorizing the same piece of content potentially multiple times for it to appear in every section of the book that makes sense etc. etc. Forgive me for rambling...really I'm just hoping to see if I'm in the right country before I get this narrowed down to a street address.

Is this feasible?
Am I on the right software path?
Is it a realistic expectation to take a single TEX file and produce four different quality file formats of PDF, ePub, Mobi & HTML?

Does the \newcommand macro approach make sense?
Can the \colorbox sequence above be written once and used hundreds/thousands of times for design purposes?

I understand this first post is far too long, but there's no sense in spreading it over 5 posts only to find out this project should use a different approach.

Oh please ignore the cascading text in attached PDF...that's me testing stuff.

Thank you VERY much Stefan!!

Brett

[Johannes_B]

Please post this as a different thread, separated from the welcome post.

[JBC]

Ok will do. Any preferred category?