Download Link Get Incomplete Source

billf82 commented 10 years ago

The download link on the source page transfers a zip file which expands into a source tree in which the greg directory is empty. As a result, make fails. I found that getting the greg master separately and copying its content into the source tree fixed the problem.

fletcher commented 10 years ago

Right. That's why you have to follow the directions in the readme.

;)

F

Sent from my iPhone

On May 15, 2014, at 10:58 AM, billf82 notifications@github.com wrote:

The download link on the source page transfers a zip file which expands into a source tree in which the greg directory is empty. As a result, make fails. I found that getting the greg master separately and copying its content into the source tree fixed the problem.

— Reply to this email directly or view it on GitHub.

billf82 commented 10 years ago

I understand. However, may I suggest consideration of a novice user¹s perspective. Your product is very nice for creating easily readable and maintainable source files. Now, someone like myself who wishes to use the product prepares to install it, but has no familiarity at all with the git command set or the git environment. For someone like that, the readme is, at best, obscure.

At the same time, on the same page there is an enticing download link. I think that veering off to a more familiar path is understandable.

Bill

William Frazier frazier@iastate.edu voice: (515) 294-8620 Iowa State University fax: (515) 294-1717 Information Technology Services, 251 Durham, Ames, Iowa 50011-2251

From: "Fletcher T. Penney" notifications@github.com Reply-To: fletcher/MultiMarkdown-4 <reply+i-33593533-6c12751e488ac8c86fbfc24ac0a1c9e73b569ccd-7593430@reply.git hub.com> Date: Thursday, May 15, 2014 at 12:56 PM To: fletcher/MultiMarkdown-4 MultiMarkdown-4@noreply.github.com Cc: William Frazier frazier@iastate.edu Subject: Re: [MultiMarkdown-4] Download Link Get Incomplete Source (#70)

Right. That's why you have to follow the directions in the readme.

;)

F

Sent from my iPhone

On May 15, 2014, at 10:58 AM, billf82 notifications@github.com wrote:

The download link on the source page transfers a zip file which expands into a source tree in which the greg directory is empty. As a result, make fails. I found that getting the greg master separately and copying its content into the source tree fixed the problem.

‹ Reply to this email directly or view it on GitHub.

‹ Reply to this email directly or view it on GitHub <https://github.com/fletcher/MultiMarkdown-4/issues/70#issuecomment-43243155

.

fletcher commented 10 years ago

I'm happy to take any suggestions on which parts of the instructions need further clarification. I tried to include the exact commands that need to be run in order to get the software to compile.

billf82 commented 10 years ago

I¹ll give it a shot. First, a little background to set the stage.

One of my colleagues found the Mac version of MultiMarkdown and used it to replace a locally developed and less clean product used to produce web based documentation. The MultiMarkdown source was more readable and the product was simpler to use. For my particular use, I needed a Linux version. I tried obtaining it from Linux repositories, but the version I got was ancient (1.003 or something like that), so I searched for version 4 which was what the Mac installer produced.

I found this web site: https://github.com/fletcher/MultiMarkdown-4 The readme toward the bottom of the page included this section:

Download the source from the github web site using git
git submodule init and then git submodule update to download greg and the test suite
Run make to compile.
Run make test-all | less to verify that the build is correct. As mentioned, one of the tests is expected to fail; the rest should pass on all systems.
Run sudo make install and (optionally) sudo make install-scripts to install multimarkdown and the helper scripts. Since I had no experience with git and noticed a convenient Download ZIP button, I decided to try that with the results described in earlier communications. I decided to re-examine the git approach. (Now, thinking back, had I known that the git submodule commands needed to be issued from within the MultiMarkdown directory, the ZIPed archive might have worked. At the time, I had no idea that git config files were included in the source.)

At any rate, I didn¹t know what git command to use. Fetch? Clone? Pull? No idea. I came across your web site (http://fletcherpenney.net/multimarkdown/install/) and followed the Linux link and found the instructions for the installation of version 3. This led me to produce the following set of commands.

git clone git://github.com/fletcher/MultiMarkdown-4.git
cd MultiMarkdown-4/
git submodule init
git submodule update This is followed, of course, by the make commands.

I suspect that you and, perhaps, most of the users of your product would echo the words of my favorite cartoon character, Mr. Obvious Man and say ³Well Duh!². In this case, I was a novice and hope my comments may make the process easier for others who are in the same boat.

Thanks, Bill

William Frazier frazier@iastate.edu voice: (515) 294-8620 Iowa State University fax: (515) 294-1717 Information Technology Services, 251 Durham, Ames, Iowa 50011-2251

From: "Fletcher T. Penney" notifications@github.com Reply-To: fletcher/MultiMarkdown-4 <reply+i-33593533-6c12751e488ac8c86fbfc24ac0a1c9e73b569ccd-7593430@reply.git hub.com> Date: Thursday, May 15, 2014 at 6:53 PM To: fletcher/MultiMarkdown-4 MultiMarkdown-4@noreply.github.com Cc: William Frazier frazier@iastate.edu Subject: Re: [MultiMarkdown-4] Download Link Get Incomplete Source (#70)

I'm happy to take any suggestions on which parts of the instructions need further clarification. I tried to include the exact commands that need to be run in order to get the software to compile.

‹ Reply to this email directly or view it on GitHub <https://github.com/fletcher/MultiMarkdown-4/issues/70#issuecomment-43279236

.

fletcher commented 10 years ago

The linux repo that you mention is not even MultiMarkdown. There was never a version 1.003, but there was some other software that used that number. This software was not created by me.

The websites you mention (this github page, and the MMD home page at fletcherpenney.net) are the official MultiMarkdown sites.

I can add the git clone command to the README.

Thanks for the feedback,

F-

Fletcher T. Penney fletcher@fletcherpenney.net

billf82 commented 10 years ago

Ah! The actual package name in the repo is perl-Text-MultiMarkdown, version 1.000032. And I see that it purports to translate your MutiMarkdown input to HTML. The package was put together by someone named Steve Huff.

Glad to be of some help.

Bill

William Frazier frazier@iastate.edu voice: (515) 294-8620 Iowa State University fax: (515) 294-1717 Information Technology Services, 251 Durham, Ames, Iowa 50011-2251

From: "Fletcher T. Penney" notifications@github.com Reply-To: fletcher/MultiMarkdown-4 <reply+i-33593533-6c12751e488ac8c86fbfc24ac0a1c9e73b569ccd-7593430@reply.git hub.com> Date: Friday, May 16, 2014 at 12:27 PM To: fletcher/MultiMarkdown-4 MultiMarkdown-4@noreply.github.com Cc: William Frazier frazier@iastate.edu Subject: Re: [MultiMarkdown-4] Download Link Get Incomplete Source (#70)

The linux repo that you mention is not even MultiMarkdown. There was never a version 1.003, but there was some other software that used that number. This software was not created by me.

The websites you mention (this github page, and the MMD home page at fletcherpenney.net) are the official MultiMarkdown sites.

I can add the git clone command to the README.

Thanks for the feedback,

F-

Fletcher T. Penney fletcher@fletcherpenney.net

‹ Reply to this email directly or view it on GitHub <https://github.com/fletcher/MultiMarkdown-4/issues/70#issuecomment-43357640

.

mn4367 commented 9 years ago

I just saw that the download links for precompiled binaries in the Installation and Usage sections on github.com/fletcher/MultiMarkdown-4 point to github.com/fletcher/peg-multimarkdown/downloads. Is that correct?

fletcher commented 9 years ago

Fixed. Thanks!

mn4367 commented 9 years ago

Sorry to bother you again, but the download links on fletcherpenney.net/multimarkdown/use/ also point to github.com/fletcher/peg-multimarkdown/downloads :-)

And https://github.com/fletcher/qlmultimarkdown no longer seems to be available.

fletcher commented 9 years ago

Links should be updated now -- thanks.

QuickLook is here https://github.com/fletcher/MMD-QuickLook. Where did you find the other link?

mn4367 commented 9 years ago

Thanks! The link is on http://fletcherpenney.net/multimarkdown/use/ in the section MultiMarkdown and Finder “Quick Look”.

fletcher commented 9 years ago

Thanks. Fixed.

On 11/25/14, 5:17 PM, mn4367 wrote:

Thanks! The link is on http://fletcherpenney.net/multimarkdown/use/ in the section /MultiMarkdown and Finder “Quick Look”/.

— Reply to this email directly or view it on GitHub https://github.com/fletcher/MultiMarkdown-4/issues/70#issuecomment-64481179.

Fletcher T. Penney fletcher@fletcherpenney.net

fletcher / MultiMarkdown-4

Download Link Get Incomplete Source #70

Bill

Bill